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What will you learn from this book? 


Head First Java is a complete learning experience in Java and “What a fun and quirky 
object-oriented programming. With this book, you'll learn the Java book! I've taught Java 
language with a unique method that goes beyond how-to manuals and for many years and 
helps you become a great programmer. Through puzzles, mysteries, can honestly say this 
and soul-searching interviews with famous Java objects, you'll quickly is the most engaging 
get up to speed on Java's fundamentals and advanced topics including resource I've ever 
lambdas, streams, generics, threading, networking, and the dreaded seen for learning to 
desktop GUI. If you have experience with another programming language, program. It makes 
Head First Java will engage your brain with more modern approaches to me want to learn 


coding—the sleeker, faster, and easier to read, write, and maintain 


Java all over again.” 
Java of today. 


—Angie Jones 
Java Champion 
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If you've read a Head First book, you know what to expect—a visually rich former Sun Microsystems 
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format designed for the way your brain works. If you haven't, you're in for 

a treat. With Head First Java, you'll learn Java through a multisensory 

experience that engages your mind, rather than by means of a text-heavy 

approach that puts you to sleep. 
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Praise for Head First Java, 3rd Edition 


“What a fun and quirky book! I’ve taught Java for many years and can honestly say this is the most engag- 
ing resource I’ve ever seen for learning to program. It makes me want to learn Java all over again!” 
— Angie Jones, Java Champion 


“HFJ has the clearest explanation of Java Streams and Lambdas I have ever read—without the hype! It 
teaches important functional programming concepts with humor and style. And it was so fun I wanted to 
learn Java all over again. If only everyone programmed Java like they teach in this book.” 

— Eric Normand, Clojure instructor and author of Grokking Simplicity 


“Oh how I wish I had had this book when I was learning Java! It is such fun to read, one forgets that it is a 
serious Java learning book. The third edition is a great step forward. It covers everything that a Java pro- 
grammer needs to know in 2022+ to become proficient in the Java language. To me the best though are 
the illustrations, which made me chuckle quite a few times. Very well done to the Java Champion authors: 
Kathy, Bert, and Trisha!” 

— Dr. Heinz M. Kabutz (The Java Specialists’ Newsletter, www.javaspecialists.eu) 


“I love Head First Java’s style of teaching, It is a ‘technical’ book but feels like fiction—hard to stop read- 
ing once you start with any chapter. It has fun and unconventional images, great analogies, fireside chats 
between a developer and compiler/runtime and so many more such features. It has a completely different 
and great way of teaching concepts that makes readers question their assumptions and beliefs, which I 
believe is crucial to letting any learner realize the power of their own curiosity. The authors of this book 
are no less than magicians. This is a must-read book for all Java developers to get started learning Java or 
to level up their existing skills in a fun way.” 

— Mala Gupta, Developer Advocate @ JetBrains, Author and Java Champion 


“T often get asked by folks new to the Java programming ecosystem, ‘What book should I start with?’ I 
always tell them Head First Java! The original editions by Kathy Sierra and Bert Bates flipped the old way 
of learning a programming language on its head, with a learner-centric way of teaching. It was simply 
revolutionary. Trisha Gee is one of the finest Java engineers and educators on the planet, and my go 
to person when I need something gnarly about the language explained in clear detail! The third edi- 
tion brought a huge smile to my face, not only for the trip down memory lane but because once more I 
learned new things about Java despite having spent over 20 years with it :-).” 

— Maritjn Verburg aka “The Diabolical Developer”; Java Champion and Principal 

Group Manager for Java @ Microsoft 


“The Head First Java book is legendary, and I can’t think of a better person than Trisha Gee to update 
it. I already knew Trisha was awesome, but I didn’t know she was funny. Now I do! The third edition is 
authoritative, entertaining, clear, and current. If there’s a better way to learn Java, I don’t know it.” 

— Holly Cummins, Senior Principal Quarkus Software Engineer, Red Hat 


“This book is a riot! It’s got curly braces, humor, objects, metaphors, syntax, fun, code, and a proper 
acknowledgment that the reader is human. It takes the process of learning seriously, but does so playfully 
and memorably. I love the metacognitive tips, the invitations to play the role of compiler, the stories, the 
visuals, and the sense that learning a programming language— like any learning—1is something that is 
open to anyone.” 


— Kevlin Henney, co-editor of 97 Things Every Java Programmer Should Know 


“I wish I’d known about this book when Pd been learning Java! For those looking to learn Java in a fun, hu- 
morous and captivating way (who knew that was possible?), and especially those who have not come from 
a traditional computer science background like myself, this is definitely the book for you. Never before 
have I laughed out loud at a programming book. It’s brilliantly written, witty, engaging, interactive, easy to 
follow and highly educational.” 

— Grace Jansen, Developer Advocate, IBM 


“If you’re just starting your journey learning how to program in Java, you’re faced with an overwhelm- 
ing choice of books and courses ready to get you to your destination. The problem is most focus purely 
on the technical information, making you frequently ask, “are we there yet?” Head First Java takes an 
altogether different approach making the adventure of learning both entertaining and educational. Using 
arrays of dogs, pool puzzles, five-minute mysteries and sharpen your pencil (who’d have thought you need 
a pencil to program?), this book makes learning fun, yet making sure you absorb all the essential details 
you'll need. I wish this had been available when I started learning Java!” 
— Simon Ritter, Deputy CTO at Azul and Java Champion 


“This book never disappoints. I still remember it from my early days at university and I am quite pleased to 
see this new improved version. Head First Java is very well put together with simple to understand English 
and coding examples. I highly recommend it to every Java developer.” 

— Nelson Djalo, Tech Entrepreneur, founder of Amigoscode.com learning platform 
and Amigoscode YouTube channel 


“Head First Java was the first book I had my son read when he wanted to learn Java. And there’s a reason: 
I knew the fun cartoons would captivate his attention like no other Java book I have seen before. Reading 
Head First Java was more like being on the playground than stuck in the classroom.” 
— Kevin Nilson, Google Software Engineer and Leader of the Silicon Valley Java User 


“T can only envy programmers who want to learn Java today, as they have this great book. I learned Java 
twenty years ago, and it was quite boring. But you'll never be bored with this book. I’ve never seen a Java 
book that has a battle between Java compiler and virtual machine. This is mind-blowing!” 

— Tagir Valeev, Java Champion and Technical Lead in IntelliJ IDEA, JetBrains 


“Nearly 20 years ago after I read Head First Java, lst edition, as a junior developer entering the Java world, 
the third edition still amazes me. Much has changed since then, including how people present tutorials. 
Head First Java, 3rd edition, is a valid alternative to today’s excellent video materials: It allows learners—ju- 
nior and senior alike—to quickly grasp concepts without losing them in details, but also without dumbing 
down the material, and with enough of the correct references for further reading, I especially enjoyed the 
material on Java streams, concurrency and NIO.” 

— Michael Simons, Java Champion and engineer at Neo4j, author of the German 
Spring Boot Buch reference 


“If you want to develop software using Java, this book is for you. Head First Java designs lots of straightfor- 
ward and elegant examples to help the readers understand and learn how to use Java to create software. 
This is a great first book for anyone who wants to be a Java programmer.” 

— Sanhong Li, Alibaba Cloud 


More praise for Head First Java, 3rd Edition 


“Head First Java is a technical book that doesn’t feel like a technical book: it’s fun, casual, and full of worldly analo- 


gies that introduce complex concepts in a very smooth way. It’s the perfect introduction to the rich and vast Java 
ecosystem.” 


— Abraham Marin-Perez, Principal Consultant, Cosota Team 


“For those who like a little whimsy and humor with their “work”, I can think of no better book for learning Java 
than Head First Java, 3rd edition. Practical and playful, educational and engaging, it’s the perfect guide for new 
developers looking to hit the ground running.” 


— Marc Loy, trainer, author of Smaller C, and co-author of Learning Java and Java Swing 


Praise for earlier editions of Head First Java, 
and for other books coauthored by Kathy and Bert 


“Kathy and Bert’s Head First Java transforms the printed page into the closest thing to a GUI you've ever seen. Ina 


wry, hip manner, the authors make learning Java an engaging ‘what’re they gonna do next?’ experience.” 
— Warren Keuffel, Software Development Magazine 


“the only way to decide the worth of a tutorial is to decide how well it teaches. Head First Java excels at teaching. 


OK, I thought it was silly...then I realized that I was thoroughly learning the topics as I went through the book.... 
The style of Head First Java made learning, well, easier.” 


— slashdot (honestpuck’s review) 


“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, Head First 
Java covers a huge amount of practical matters that other texts leave as the dreaded “exercise for the reader...” It’s 


clever, wry, hip and practical—there aren’t a lot of textbooks that can make that claim and live up to it while also 
teaching you about object serialization and network launch protocols.” 


—Dr. Dan Russell, Director of User Sciences and Experience Research IBM Almaden 
Research Center (and teaches Artificial Intelligence at Stanford University) 


“Tt’s fast, irreverent, fun, and engaging. Be careful—you might actually learn something!” 


—Ken Arnold, former Senior Engineer at Sun Microsystems and coauthor (with James 
Gosling, creator of Java) of The Java Programming Language 


“Java technology is everywhere. If you develop software and haven’t learned Java, it’s definitely time to dive in— 
Head First.” 
—Scott McNealy, former Sun Microsystems Chairman, President, and CEO 


“Head First Java is like Monty Python meets the gang of four...the text is broken up so well by puzzles and stories, 
quizzes and examples, that you cover ground like no computer book before.” 
—Douglas Rowe, Columbia Java Users Group 


“Read Head First Java and you will once again experience fun in learning...For people who like to learn new 
programming languages, and do not come from a computer science or programming background, this 
book is a gem... This is one book that makes learning a complex computer language fun.” 

— Judith Taylor, Southeast Ohio Macromedia User Group 


“If you want to learn Java, look no further: welcome to the first GUI-based technical book! This perfectly- 
executed, ground-breaking format delivers benefits other Java texts simply can’t...Prepare yourself for a 
truly remarkable ride through Java land.” 

— Neil R. Bauman, Captain and CEO, Geek Cruises 


“Twas ADDICTED to the book’s short stories, annotated code, mock interviews, and brain exercises.” 
— Michael Yuan, author of Enterprise J2ME 


“Head First Java gives new meaning to their marketing phrase “There’s an O’Reilly for that.’ I picked this 
up because several others I respect had described it in terms like ‘revolutionary’ and described a radically 
different approach to the textbook. They were (are) right...In typical O’Reilly fashion, they’ve taken a 
scientific and well considered approach. The result is funny, irreverent, topical, interactive, and brilliant... 
Reading this book is like sitting in the speakers lounge at a conference, learning from—and laughing 
with—peers...If you want to UNDERSTAND Java, go buy this book.” 

—Andrew Pollack, www.thenorth.com 


“This stuff is so fricking good it makes me wanna WEEP! I’m stunned.” 
— Floyd Jones, Senior Technical Writer /Poolboy, BEA 


“T feel like a thousand pounds of books have just been lifted off of my head.” 
— Ward Cunningham, inventor of the Wiki and founder of the Hillside Group 


“T laughed, I cried, it moved me.” 
— Dan Steinberg, Editor-in-Chief, java.net 


“My first reaction was to roll on the floor laughing. After I picked myself up, I realized that not only is 
the book technically accurate, it is the easiest to understand introduction to design patterns that I have 
seen.” 

— Dr. Timothy A. Budd, Associate Professor of Computer Science at Oregon State 
University; author of more than a dozen books including C++ for Java Programmers 


“Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for practi- 
cal development strategies—gets my brain going without having to slog through a bunch of tired stale 
professor-speak.” 

— Travis Kalanick, founder of Scour and Red Swoosh, member of the MIT TR100 
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Authors of Head First Java and Creators of the Head First series 


Kathy Sierra 


Kathy has been interested in learning theory since her 
days as a game designer for Virgin, MGM, and Amblin’, 
and a teacher of New Media Authoring at UCLA. She 

was a master Java trainer for Sun Microsystems, and she 
founded JavaRanch.com (now CodeRanch.com), which won 
Jolt Cola Productivity awards in 2003 and 2004. 


In 2015, she won the Electronic Frontier Foundation’s 
Pioneer Award for her work creating skillful users and 
building sustainable communities. 


Kathy’s recent focus has been on cutting-edge, movement 
science and skill acquisition coaching, known as ecological 
dynamics or “Eco-D.” Her work using Eco-D for training 
horses is ushering in a far, far more humane approach 

to horsemanship, causing delight for some (and sadly, 
consternation for others). ‘Those fortunate (autonomous!) 
horses whose owners are using Kathy’s approach are 
happier, healthier, and more athletic than their fellows who 
are traditionally trained. 


You can follow Kathy on Instagram: 
@pantherflows. 


Before Bert was an author, he was a developer, 
specializing in old-school AI (mostly expert systems), 
real-time OSs, and complex scheduling systems. 


In 2003, Bert and Kathy wrote Head First Java and 
launched the Head First series. Since then, he’s 
written more Java books and consulted with Sun 
Microsystems and Oracle on many of their Java 
certifications. These days, he works with coaches, 
teachers, professors, authors, and editors, helping 
them create more bad-ass training for their students. 


Bert’s a Go player, and in 2016 he watched in horror 
and fascination as AlphaGo trounced Lee Sedol. 
Recently he’s been using Eco-D (ecological dynamics) 
to improve his golf game and to train his parrotlet 
Bokeh. 


Bert has been privileged to know Trisha Gee for 
more than eight years now, and the Head First series 
is extremely fortunate to count Trisha as one of its 
authors. 


You can email Bert at bertbates.hf@gmail.com. 
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Co-author of Head First Java, 3rd Edition 


Trisha Gee 


Trisha has been working with Java since 1997, when her university was forward- 
looking enough to adopt this “shiny new” language to teach computer science. Since 
then, she’s worked as a developer and consultant, creating Java applications in a 
range of industries including banking, manufacturing, nonprofit, and low-latency 
financial trading, 


Trisha is super passionate about sharing all the stuff she learned the hard way 
during those years as a developer, so she became a Developer Advocate to give 

her an excuse to write blog posts, speak at conferences, and create videos to pass 
on some of her knowledge. She spent five years as a Java Developer Advocate at 
JetBrains, and another two years leading the JetBrains Java Advocacy team. During 
this time she learned a lot about the kinds of problems real Java developers face. 


Trisha has been talking to Bert (on and off) about updating Head First Java for the 
last eight years! She remembers those weekly phone calls with Bert with great 
affection; regular contact with a knowledgable and warm human being like Bert 
helped keep her sane. Bert and Kathy’s approach to encouraging learning has 
formed the core of what she’s been trying to do for nearly 10 years. 


You can follow Trisha on Twitter: @trisha_gee. 
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@ Intro 


Ji Your brain on Java. Here you are trying to learn something, while here your brain 
is doing you a favor by making sure the learning doesn’t stick. Your brain’s thinking, “Better 
leave room for more important things, like which wild animals to avoid and whether naked 
snowboarding is a bad idea” So how do you trick your brain into thinking that your life 
depends on knowing Java? 
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table of contents 
Breaking the Surface 


Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with its friendly syntax, object-oriented fea- 
tures, memory management, and best of all—the promise of portability. We'll take a quick dip 
and write some code, compile it, and run it. We're talking syntax, loops, branching, and what 
makes Java so cool. Dive in. 
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A Trip to Objectville 


| was told there would be objects. In Chapter 1, we put all of our code in 
the main() method. That’s not exactly object-oriented. So now we've got to leave that 
procedural world behind and start making some objects of our own. We'll look at what 
makes object-oriented (OO) development in Java so much fun. We'll look at the difference 
between a class and an object. We'll look at how objects can improve your life. 


Chair Wars 28 
one class Making your first object 36 
Making and testing Movie objects 37 
Quick! Get out of main! 38 
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Exercises 42 
Exercise Solutions 47 
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Know Your Variables 


Variables come in two flavors: primitive and reference. 

There's gotta be more to life than integers, Strings, and arrays. What if you have a PetOwner 
object with a Dog instance variable? Or a Car with an Engine? In this chapter we'll unwrap 
the mysteries of Java types and look at what you can declare as a variable, what you can put 
in a variable, and what you can do with a variable. And we'll finally see what life is truly like 
on the garbage-collectible heap. 


Declaring a variable 50 
“Td like a double mocha, no, make it an int.” 51 
Back away from that keyword! 53 
Controlling your Dog object 54 
An object reference is just another variable value. 55 
Life on the garbage-collectible heap 57 
An array is like a tray of cups 59 
A Dog example 62 
Dog reference Exercises 63 
Exercise Solutions 68 


How Objects Behave 


State affects behavior, behavior affects state. We know that objects 
have state and behavior, represented by instance variables and methods. Now we'll look 
at how state and behavior are related. An object's behavior uses an object’s unique state. 

In other words, methods use instance variable values. Like, “if dog weight is less than 14 
pounds, make yippy sound, else...” Let’s go change some state! 


Remember: a class describes what an object knows and 


pass-by-value means what an object does 72 
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Exercises 88 
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Extra-Strength Methods 


table of contents 


Let’s put some muscle in our methods. You dabbled with variables, 
played with a few objects, and wrote a little code. But you need more tools. Like 
operators. And loops. Might be useful to generate random numbers. And turn 
a String into an int, yeah, that would be cool. And why don't we learn it all by building 


something real, to see what it’s like to write (and test) a program from scratch. Maybe a 


game, like Sink a Startup (similar to Battleship). 


Let’s build a Battleship-style game: “Sink a Startup” 
Developing a Class 

Writing the method implementations 

Writing test code for the SimpleStartup class 

The checkYourself() method 


Prep code for the SimpleStartupGame class 
The game’s main() method 

Let’s play 

More about for loops 

The enhanced for loop 
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Exercises 


Exercise Solutions 
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Using the Java Library 


Java ships with hundreds of prebuilt classes. You don't have to 
reinvent the wheel if you know how to find what you need from the Java library, commonly 


known as the Java API. You've got better things to do. If you're going to write code, you 


might as well write only the parts that are custom for your application. The core Java library 


is a giant pile of classes just waiting for you to use like building blocks. 


“Good to know there’s an ArrayList in the java. 
util package. But by myself, how would I have 
figured that out?” 


- Julia, 31, hand model 


In our last chapter, we left you with the cliff-hanger. A bug. 
Wake up and smell the library 

Some things you can do with ArrayList 

Comparing ArrayList to a regular array 

Lets build the REAL game: “Sink a Startup” 

Prep code for the real StartupBust class 

The final version of the Startup class 

Super Powerful Boolean Expressions 

Using the Library (the Java API) 

Exercises 


Exercise Solutions 
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Better Living in Objectville 


Plan your programs with the future in mind. what if you could write 
code that someone else could extend, easily? What if you could write code that was flexible, for 
those pesky last-minute spec changes? When you get on the Polymorphism Plan, you'll learn the 
5 steps to better class design, the 3 tricks to polymorphism, the 8 ways to make flexible code, 
and if you act now—a bonus lesson on the 4 tips for exploiting inheritance. 


Java is — 
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Serious Polymorphism 


Inheritance is just the beginning. To exploit polymorphism, we need 
interfaces. We need to go beyond simple inheritance to flexibility you can get only by 
designing and coding to interfaces. What’s an interface? A 100% abstract class. What’s an 
abstract class? A class that can’t be instantiated. What’s that good for? Read the chapter... 


Did we forget about something when we designed this? 200 
Object o = al.get (id); The compiler won't let you instantiate an abstract class 203 
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Life and Death of an Object 


Objects are born and objects die. You're in charge. You decide when and 
how to construct them. You decide when to abandon them. The Garbage Collector (gc) 


reclaims the memory. We'll look at how objects are created, where they live, and how to 


keep or abandon them efficiently. That means we'll talk about the heap, the stack, scope, 


constructors, super constructors, null references, and gc eligibility. 
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Sorting isa snap in Java. You have all the tools for collecting and manipulating 
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Risky Behavior 


Stuff happens. The file isn’t there. The server is down. No matter how good a 


programmer you are, you can't control everything. When you write a risky method, you 


need code to handle the bad things that might happen. But how do you know when a 


method is risky? Where do you put the code to handle the exceptional situation? In this 


chapter, we're going to build a MIDI Music Player that uses the risky JavaSound API, so we 


better find out. 
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Face it, you need to make GUIs. Even if you believe that for the rest of your 
life you'll write only server-side code, sooner or later you'll need to write tools, and you'll 


want a graphical interface. We'll spend two chapters on GUls and learn more language 


features including Event Handling and Inner Classes. We'll put a button on the screen, 
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Work on Your Swing 
Swing is easy. Unless you actually care where everything goes. Swing code looks 


easy, but then compile it, run it, look at it, and think, “hey, that’s not supposed to go there.” 
The thing that makes it easy to code is the thing that makes it hard to contro/—the Layout 
Manager. But with a little work, you can get layout managers to submit to your will. In 
this chapter, we'll work on our Swing and learn more about widgets. 
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Objects can be flattened and inflated. Objects have state and behavior. 
Behavior lives in the class, but state lives within each individual object. If your program 
needs to save state, you can do it the hard way, interrogating each object, painstakingly 
writing the value of each instance variable. Or, you can do it the easy OO way—you simply 
freeze-dry the object (serialize it) and reconstitute (deserialize) it to get it back. 
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Make a Connection 


Connect with the outside world. It’s easy. All the low-level networking 
details are taken care of by classes in the java.net library. One of Java's best features is 

that sending and receiving data over a network is really just I/O with a slightly different 
connection stream at the end of the chain. In this chapter we'll make client sockets. We'll 
make server sockets. We'll make clients and servers. Before the chapter's done, you'll have a 
fully functional, multithreaded chat client. Did we just say multithreaded? 
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(objects that don't change) that are safe for multiple threads to use. By the end of the chapter, you'll 


have a lot of different tools in your toolkit for working with concurrency. 
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Appendix B 


The top ten-ish topics that didn’t make it into the rest of the 


book. we can't send you out into the world just yet. We have a few more things for you, 


but this is the end of the book. And this time we really mean it. 


#11 JShell (Java REPL) 

#10 Packages 

#9 Immutability in Strings and Wrappers 

#8 Access levels and access modifiers (who sees what) 
#7 Varargs 

#6 Annotations 

#5 Lambdas and Maps 

#4 Parallel Streams 

#3 Enumerations (also called enumerated types or enums) 
#2 Local Variable Type Inference (var) 

#1 Records 
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Who is this book for? 


If you can answer “yes” to all of these: wave 
Á 4 This is NOT a reference 


© Have you done some programming? book. Head First Java is a 
book designed for learning, 
© Do you want to learn Java? not an encyclopedia of 


Java facts. 


Do you prefer stimulating dinner party 
conversation to dry, dull, technical 
lectures? 


this book is for you. 


Who should probably back away from this book? 


If you can answer “yes” to any one of these: 


© Is your programming background limited 
to HTML only, with no scripting language 
experience? 
(If you’ve done anything with looping or if/then logic, 
you'll do fine with this book, but HTML tagging 
alone might not be enough.) 


© Are you a kick-butt C++ programmer 
looking for a reference book? 


© Are you afraid to try something different? 
Would you rather have a root canal than 
mix stripes with plaid? Do you believe 
that a technical book can’t be serious if 
there’s a picture of a duck in the memory 
management section? 


this book is not for you. 


C t f m m ina: 
es A z ma ng: who took out the part about how 


anyone with a valid credit card? 
about that “Give the 6; weit Caras And what 
disused... bog: e Gift of Java holiday Promotion we 
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the intro 


We know what youre thinking 


“How can this be a serious Java programming book?” 


“What’s with all the graphics?” 


“Can I actually learn it this way?” 


“Do I smell pizza?” 


And we know what your brain is thinking 


Your brain craves novelty. It’s always searching, scanning, wazting for 
something unusual. It was built that way, and it helps you stay alive. 


Today, you’re less likely to be a tiger snack. But your brain’s still looking. You 
just never know. 


So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real job—recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important” 
filter. 


How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you, what happens inside your head? 


Neurons fire. Emotions crank up. Chemicals surge. 


Great. Only 
And that’s how your brain knows... Gna a 


This must be important! Don’t forget it! yanks 
‘ : ; : ; am O 
But imagine you’re at home, or in a library. It’s a safe, warm, tiger-free zone. yo“ ae % worth 0 


THIS \sn 


You’re studying. Getting ready for an exam. Or trying to learn some tough ewe 
s 


technical topic your boss thinks will take a week, ten days at the most. 


Just one problem. Your brain’s trying to do you a big favor. It’s trying to 
make sure that this obviously non-important content doesn’t clutter up 
scarce resources. Resources that are better spent storing the really 
big things. Like tigers. Like the danger of fire. Like how you should 


never again snowboard in shorts. 


And there’s no simple way to tell your brain, “Hey, brain, thank you 
very much, but no matter how dull this book is, and how little Pm 
registering on the emotional richter scale right now, I really do want 
you to keep this stuff around.” 
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how to use this book 


we think of a Head First Java reader as a learner. 


So what does it take to learn something? First, you have to getit, then make sure 
you don’t forget it. It’s not about pushing facts into your head. Based on the 
latest research in cognitive science, neurobiology, and educational psychology, 
learning takes a lot more than text on a page. We know what turns your brain on. 


Some of the Head First learning principles: 


needs to call a 


met! 
Make it visual. Images are far more memorable than words — on the RMI remote 


service 


alone, and make learning much more effective (up to 89% 


improvement in recall and transfer studies). It also makes 
things more understandable. Put the words within 


doCalc() 


or near the graphics they relate to, rather than onthe | eetuenvalue 


bottom or on another page, and learners will be up to twice 


as likely to solve problems related to the content. EA 


Use a conversational and personalized style. In recent studies, 


Tt really sucks to be an students performed up to 40% better on post-learning tests if the content spoke 


abstract method. You 
don't have a body. 


directly to the reader, using a first-person, conversational style rather than taking 


a formal tone. Tell stories instead of lecturing. Use casual language. Don't take 


yourself too seriously. Which would you pay more attention to: a stimulating 


dinner party companion, Or a lecture? 


Get the learner to think more deeply. In other words, unless 
you actively flex your neurons, nothing much happens in your head. 


Does it make sense to 
say Tub IS-A Bathroom? 
Bathroom IS-A Tub? Or is 


i) 

C) 

@ 
= 


Å= A reader has to be motivated, engaged, curious, and inspired to 
; it a HAS-A relationship? 
4 il i. solve problems, draw conclusions, and generate new knowledge. 
© \ q | And for that, you need challenges, exercises, thought- 
—— ġid roam(); provoking questions, and activities that involve both sides 
of the brain and multiple senses. 
Yo! y A 
No ne se rao" i; 


Get—and keep—the reader’s attention. We've all k 
had the “I really want to learn this but | can’t stay awake past ; i l 
page one” experience. Your brain pays attention to things that are out p i 


of the ordinary, interesting, strange, eye-catching, unexpected. Learning a new, 


tough, technical topic doesn’t have to be boring. Your brain will learn much more quickly if it’s not. 


Touch their emotions. We now know that your ability to remember something is largely 


dependent on its emotional content. You remember what you care about. You remember when 


you feel something. No we're not talking heart-wrenching stories about a boy and his dog. 


We're talking emotions like surprise, curiosity, fun, “what the...?", and the feeling of “I Rule!” 


that comes when you solve a puzzle, learn something everybody else thinks is hard, or realize 


you know something that “I’m more technical than thou" Bob from engineering doesn't. 
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Metacognition: thinking about thinking 


I wonder how I 

can trick my brain 
into remembering this 
stuff... 


If you really want to learn, and you want to learn more quickly and more deeply, pay 
attention to how you pay attention. Think about how you think. Learn how you learn. 


Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. oO 


But we assume that if you’re holding this book, you want to learn Java. And you probably 
don’t want to spend a lot of time. 


To get the most from this book, or any book or learning experience, take responsibility for 
your brain. Your brain on that content. 


The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 

Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 


So just how DO you get your brain to treat Java like 
it was a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective way. The slow way is about 
sheer repetition. You obviously know that you ave able to learn and remember even the 
dullest of topics, if you keep pounding on the same thing. With enough repetition, your 
brain says, “This doesn’t feel important to him, but he keeps looking at the same thing over 
and over and over, so I suppose it must be.” 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning, 
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Here's what WE did: 


We used pictures, because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really 7s worth 1024 words. And when text and pictures work together, 
we embedded the text in the pictures because your brain works more effectively when the 
text is within the thing the text refers to, as opposed to in a caption or buried in the text 
somewhere. 


We used repetition, saying the same thing in different ways and with different media 
types, and multiple senses, to increase the chance that the content gets coded into more than 
one area of your brain. 


We used concepts and pictures in unexpected ways because your brain is tuned for 
novelty, and we used pictures and ideas with at least some emotional content, because your 
brain is tuned to pay attention to the biochemistry of emotions. That which causes you to 
feel something is more likely to be remembered, even if that feeling is nothing more than a 
little humor, surprise, or interest. 


We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you're reading. 


We included more than 50 exercises because your brain is tuned to learn and remember 
more when you do things than when you read about things. And we made the exercises 
challenging-yet-do-able, because that’s what most people prefer. 


We used multiple learning styles, because you might prefer step-by-step procedures, 
while someone else wants to understand the big picture first, while someone else just wants 
to see a code example. But regardless of your own learning preference, everyone benefits 
from seeing the same content represented in multiple ways. 


We include content for both sides of your brain, because the more of your brain 

you engage, the more likely you are to learn and remember, and the longer you can stay 
focused. Since working one side of the brain often means giving the other side a chance to 
rest, you can be more productive at learning for a longer period of time. 


And we included stories and exercises that present more than one point of view, 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 


We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work 
at something (just as you can’t get your body in shape by watching people at the gym). But 
we did our best to make sure that when you’re working hard, it’s on the right things. That 
you’re not spending one extra dendrite processing a hard-to-understand example, or 
parsing difficult, jargon-laden, or extremely terse text. 


We used an 80/20 approach. We assume that if you’re going for a PhD in Java, this won’t 
be your only book. So we don’t talk about everything. Just the stuff you'll actually use. 
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BULLET POINTS 


Cut this out and stiek it 


Sn your refrigerator. 


Slow down. The more you understand, 
the less you have to memorize. 


Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to the 
answer. Imagine that someone really zs asking 
the question. The more deeply you force your 
brain to think, the better chance you have of 
learning and remembering. 


Do the exercises. Write your own notes. 


We put them in, but if we did them for you, 
that would be like having someone else do 
your workouts for you. And don’t just look at 
the exercises. Use a pencil. There’s plenty of 
evidence that physical activity while learning 
can increase the learning, 


Read the “There are No Dumb Questions” 
That means all of them. They’re not optional 
sidebars—they’re part of the core content! 
Sometimes the questions are more useful than 

the answers. 


Don’t do all your reading in one place. 
Stand up, stretch, move around, change chairs, 
change rooms. It'll help your brain feel something, 
and it keeps your learning from being too 
connected to a particular place. 


Make this the last thing you read before 


bed. Or at least the last challenging thing. 


Part of the learning (especially the transfer to 
long-term memory) happens after you put the 
book down. Your brain needs time on its own, to 
do more processing. If you put in something new 
during that processing time, some of what you 
just learned will be lost. 


what doesn’t. Try new things. 


© 
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Here's what YOU can do to bend your 
brain into submission 


So, we did our part. The rest is up to you. These tips are a starting 
point; Listen to your brain and figure out what works for you and 


Drink water. Lots of it. 


Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 


Talk about it. Out loud. 

Speaking activates a different part of the brain. 
If you’re trying to understand something or 
increase your chance of remembering it later, say 
it out loud. Better still, try to explain it out loud 
to someone else. You'll learn more quickly, and 
you might uncover ideas you hadn’t known were 
there when you were reading about it. 


Listen to your brain. 


Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim the 
surface or forget what you just read, it’s time for a 
break. Once you go past a certain point, you won’t 
learn faster by trying to shove more in, and you 
might even hurt the process. 


Feel something! 


Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke is 
still better than feeling nothing at all. 


Type and run the code. 


Type and run the code examples. Then you can 
experiment with changing and improving the code 
(or breaking it, which is sometimes the best way to 
figure out what’s really happening). Most of the 
code, expecially long examples and Ready-Bake 
Code, are at https://oreil. ly /hffava_3e_examples. 
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What you need for this book: 


You do not need any other development tool, such as an Integrated 
Development Environment (IDE). We strongly recommend that you 
not use anything but a basic text editor until you complete this book. 
An IDE can protect you from some of the details that really matter, so 
you're much better off learning from the command line and then, once 
you really understand what’s happening, move to a tool that automates 
some of the process. 


-—— SETTING UP JAVA 


This book assumes you’re 
using Java 11 (with the 
exception of Appendix B). 
However, if you’re using 
Java 8, you will find most 
of the code still works. 


If there’s discussion of a 
feature from a version of 
Java higher than Java 8, 


the required version will 
be mentioned. 


Because versions are moving quickly and advice on the right JDK to use may change, we’ve 
put detailed instructions on how to install Java into the code samples project online: 


https://oreil.ly/hfJava_install 
This is a simplified version. 
If you don’t know which version of Java to download, we recommend using Java 17. 


There are many free builds of OpenJDK available (the open source version of Java). We 
suggest the community-supported Eclipse Adoptium JDK at https://adoptium.net. 


The JDK includes everything you need to compile and run Java. The JDK does not include the 
API documentation, and you need that! Download the Java SE API documentation. You can 


also access the API docs online without downloading them, but trust us, it's worth the download. 


You need a text editor. Virtually any text editor will do (vi, emacs), including the GUI ones that 
come with most operating systems. Notepad, Wordpad, TextEdit, etc., all work, as long as 
you're using plain text (not rich text) and make sure they don’t append a “txt” on to the end of 
your source code (“java”) file. 


Once you've downloaded and unpacked/installed/whatever (depends on which version and for 
which OS), you need to add an entry to your PATH environment variable that points to the bin 
directory inside the main Java directory. The bin directory is the one you need a PATH to, so 
that when you type: 


% javac 


at the command line, your terminal will know how to find the javac compiler. 


Note: if you have trouble with your installation, we recommend you go to javaranch.com and 
join the Java-Beginning forum! Actually, you should do that whether you have trouble or not. 


The code from this book is available at Attps://oreil.ly/hffava_3e_examples. 
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Last-minute things you need to know: 


This is a learning experience, not a reference book. We deliberately stripped out 
everything that might get in the way of learning whatever it is we’re working on 
at that point in the book. And the first time through, you need to begin at the 
beginning, because the book makes assumptions about what you’ve already seen 
and learned. 


We use simple UML-like diagrams. 


If we’d used pure UML, you'd be seeing something that looks like Java, but with 
syntax that’s just plain wrong. So we use a simplified version of UML that doesn’t 
conflict with Java syntax. If you don’t already know UML, you won’t have to 
worry about learning Java and UML at the same time. 


We don’t worry about organizing and packaging your own 
code. 


In this book, you can get on with the business of learning Java, without stressing 
over some of the organizational or administrative details of developing Java 
programs. You will, in the real world, need to know—and use—these details, but 
since building and deploying Java applications generally relies on third-party build 
tools like Maven and Gradle, we have assumed you'll learn those tools separately. 


The end-of-chapter exercises are mandatory; puzzles are 
optional. Answers for both are at the end of each chapter. 


One thing you need to know about the puzzles—they’re puzzles. As in logic puzzles, 
brain teasers, crossword puzzles, etc. The exercises are here to help you practice 
what you’ve learned, and you should do them all. The puzzles are a different story, 
and some of them are quite challenging in a puzzle way. These puzzles are meant 
for puzzlers, and you probably already know if you are one. If you’re not sure, we 
suggest you give some of them a try, but whatever happens, don’t be discouraged 
if you can’t solve a puzzle or if you simply can’t be bothered to take the time to 
work them out. 


The “Sharpen Your Pencil” exercises don’t all have 
answers. 

Not printed in the book, anyway. For some of them, there zs no right answer, and 
for the others, part of the learning experience for the Sharpen activities is for you 
to decide if and when your answers are right. 


The code examples are as lean as possible. 


It’s frustrating to wade through 200 lines of code looking for the two lines you 
need to understand. Most examples in this book are shown within the smallest 
possible context, so that the part you’re trying to learn is clear and simple. So 
don’t expect the code to be robust, or even complete. That’s your assignment for 
after you finish the book. The book examples are written specifically for learning 
and aren’t always fully functional. 
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Dog 
size 
bark() 


eat() 
chaseCat() 


You should do ALL 


of the “Sharpen your 
pencil” activities 


Gedharpen your pencil 
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how to use this book 


Technical Reviewers for the 3rd Edition 


Abraham Marin—-Perez. 


Mare started with Java training at Sun Microsystems Abraham js a Java programmer, consultant, author, 

in the early days (shout-out to HotJava!) and never and public speaker with more than ten years of experience 
looked back. He authored a number of early Java books in a variety of industries. Originally from Valencia, 

and training courses, working with a wide variety of Spain, Abraham has built most of his career in London, 
companies across the US, Europe, and Asia along the UK, working with entities like JP Morgan or the United 
way. Most recently for O’Reilly, Marc authored Smaller Kingdom’s Home Office, frequently in collaboration 

C and co-authored the fifth edition of Learning Java. with Equal Experts. ‘Thinking his experiences could be 
Currently in Ohio, Marc is a software developer and useful to others, Abraham became a Java news editor at 
maker specializing in microcontrollers. InfoQ, authored Real-World Maintainable Software, and co- 


authored Continuous Delivery in Java. He also helps run the 
London Java Community. Always the learner, Abraham is 
pursuing a degree in physics. 
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Other people to acknowledge for the 3rd Edition 


At O’Reilly: 


Huge thanks to Zan McQuade and Nicole Taché for enabling us to finally get this edition out! Zan, thanks 
for connecting Trisha back up to the Head First world, and Nicole, fantastic work driving us to get this done. 
Thanks to Meghan Blanchette, who left O’Reilly a hundred years ago, but it was she who introduced Bert 
and ‘Trisha back in 2014. 


Trisha would like to thank: 


Helen Stott 


Helen Scott, for providing frequent feedback on the new topics covered. She consistently stopped me 
from going too deep or assuming too much knowledge, and is a true champion of the learner. I can’t wait 
to start working even more closely with her on our next project. 


My team at JetBrains for their patience and encouragement: Dalia Abo Sheasha, for test-driving the 
lambdas and streams chapter, and Mala Gupta, for giving me exactly the mformation I needed about 
modern Java certifications. Extra special thanks to Hadi Hariri for all his support, always. 


The Friday Pub Lunch informaticos, for tolerating lunchtime conversations on whatever aspect of Java I was 
trying to explain that day or week, and Alys, Jen, and Clare for helping me to figure out when to prioritize 
this book over family. Thanks to Holly Cummins for finding a last minute bug. 


Evie and Amy for the suggestions on how to improve the ice cream examples for Java’s Optional type. 
Thank you both for being genuinely interested in my progress, and for the spontaneous high-fives when you 


heard Id finished. 


None of this would have been possible without Israel Boza Rodriguez. You put up with me derailing 
important conversations like “what should we have for dinner?” with questions like “do you think 
CountDownLatch is too niche to teach beginner developers?” Crucially, you helped me to create space and 
time to work on the book, and regularly reminded me why I wanted to take on the project in the first place. 


Thank you to Bert and Kathy for bringing me on this journey. It was an honor to learn how to be a Head 
First author from the horse’s mouth, so to speak. 


Bert and Kathy would like to thank: 


Beth Robson and Eric Freeman, for their overall, ongoing, badass support of the Head First series. A 
special thanks to Beth for the many conversations we had discussing what new Java topics to teach and how 
to teach them. 


Paul Wheaton and the amazing moderators at CodeRanch.com (a.k.a. JavaRanch), for keeping CodeRanch 
a friendly place for Java beginners. A special thanks to Campbell Ritchie, Jeanne Boyarsky, Stephan 
van Hulst, Rob Spoor, Tim Cooke, Fred Rosenberger, and Frits Walraven for their mvaluable input 
concerning what have been the truly important additions to Java since the 2nd edition. 


Dave Gustafson, for teaching me so much about software development and rock climbing, AND for great 
discussions concerning the state of programming. Eric Normand, for teaching us a little FP, and helping 
us figure out how to slip a few of the best ideas from FP into an OO book. Simon Roberts, for his ongoing 
and passionate teaching of Java to students all over the world. ‘Thanks to Heinz Kabutz and Venkat 
Subramaniam for helping us explore the nooks and crannies of Java Streams. 


Laura Baldwin and Mike Loukides, for their tireless support of Head First for all these years. 
Ron Bilodeau and Kristen Brown, for their outstanding, always patient and friendly support. 
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Technical Editors for the 2nd Edition 


Endless thanks to Jessica and Val for their hard work editing the 2nd 
edition. 


Jess works at Hewlett-Packard on the Self- 
Healing Services Team. She has a bachelor’s in 
computer engineering from Villanova University, 
has her SCJP 1.4 and SCWCD certifications, 
and is literally months away from receiving 
her master’s in software engineering at Drexel 
University (whew!). 


When she’s not working, studying, or motoring 
in her MINI Cooper S, Jess can be found 
fighting her cat for yarn as she completes her 
latest knitting or crochet project (anybody want a 
hat?). She is originally from Salt Lake City, Utah 
(no, she’s not Mormon...yes, you were too going 
to ask) and is currently living near Philadelphia 
with her husband, Mendra, and two cats: Chai 
and Sake. 


You can catch her moderating technical forums 
at javaranch.com. 
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Valentin Crettaz 
L 


Valentin’s tie 


Valentin has a master’s degree in information 
and computer science from the Swiss Federal 
Institute of Technology in Lausanne (EPFL). 

He has worked as a software engineer with SRI 
International (Menlo Park, CA) and as a principal 
engineer in the Software Engineering Laboratory of 
EPFL. 


Valentin is the cofounder and CTO of Condris 
Technologies, a company specializing in the 
development of software architecture solutions. 


His research and development interests include 
aspect-oriented technologies, design and 
architectural patterns, web services, and software 
architecture. Besides taking care of his wife, 
gardening, reading, and doing some sport, Valentin 
moderates the SCBCD and SCDJWS forums at 
Javaranch.com. He holds the SCJP, SCJD, SCBCD, 
SCWCD, and SCDJWS certifications. He has also 
had the opportunity to serve as a co-author for 


Whizlabs SCBCD Exam Simulator. 


(We’re still in shock from seeing him in a te.) 
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di 


Jef Cumps 
Covey MeGlore 


Our biggest thanks to Mike Loukides at O’Reilly, for taking a chance 
on this, and helping to shape the Head First concept into a book (and 
series). As this second edition goes to print there are now five Head First 
books, and he’s been with us all the way. To Tim O’Reilly, for his 
willingness to launch into something completely new and different. ‘Thanks 
to the clever Kyle Hart for figuring out how Head First fits into the 
world and for launching the series. Finally, to Edie Freedman for 
designing the Head First “emphasize the head” cover. 


Our intrepid beta testers and reviewer team: 


Our top honors and thanks go to the director of our javaranch tech 
review team, Johannes de Jong. This is your fifth time around with us 
on a Head First book, and we’re thrilled you’re still speaking to us. Jeff 
Cumps is on his third book with us now and relentless about finding 
areas where we needed to be more clear or correct. 


Corey McGlone, you rock. And we think you give the clearest 
explanations on JavaRanch. You'll probably notice we stole one or two 
of them. Jason Menard saved our technical butts on more than a 
few details, and Thomas Paul, as always, gave us expert feedback and 
found the subtle Java issues the rest of us missed. Jane Griscti has her 
Java chops (and knows a thing or two about writing), and it was great to 


Thomas Paul 


have her helping on the new edition along with long-time javarancher 
Barry Gaunt. 


Marilyn de Queiroz gave us excellent help on both editions of the 
book. Chris Jones, John Nyquist, James Cubeta, Terri 
Cubeta, and Ira Becker gave us a ton of help on the first edition. 


Special thanks to a few of the Head Firsters who’ve been helping us Mavilym de 
from the beginning: Angelo Celeste, Mikalai Zaikin, and Queiroz 
Thomas Duff (twduff.com). And thanks to our terrific agent, David 
Rogelberg of StudioB (but seriously, what about the move rights?) 


James Cubeta Terri Cubeta John Nyquist Chris Jones 
Ira Becker 


Rodney , 
Woodruff 
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still more acknowledgments 


Just when you thought there wouldn't be any 
more acknowledgments* 


More Java technical experts who helped out on the first edition (in pseudo-random 
order): 


Emiko Hori, Michael Taupitz, Mike Gallihugh, Manish Hatwalne, James Chegwidden, Shweta 
Mathur, Mohamed Mazahim, John Paverd, Joseph Bih, Skulrat Patanavanich, Sunil Palicha, 
Suddhasatwa Ghosh, Ramki Srinivasan, Alfred Raouf, Angelo Celeste, Mikalai Zaikin, John 
Zoetebier, Jim Pleger, Barry Gaunt, and Mark Dielen. 


The first edition puzzle team: 


Dirk Schreckmann, Mary “JavaCross Champion” Leners, Rodney J. Woodruff, Gavin Bong, and 
Jason Menard. Javaranch is lucky to have you all helping out. 


Other co-conspirators to thank: 


Paul Wheaton, the javaranch Trail Boss for supporting thousands of Java learners. 

Solveig Haugland, mistress of J2EE and author of Dating Design Patterns. 

Authors Dori Smith and Tom Negrino (backupbrain.com), for helping us navigate the tech 
book world. 


Our Head First partners in crime, Eric Freeman and Beth Freeman (authors of Head First 
Design Patterns), for giving us the Bawls™ to finish this on time. 


Sherry Dorris, for the things that really matter. 


Brave early adopters of the Head First series: 


Joe Litton, Ross P. Goldberg, Dominic Da Silva, honestpuck, Danny Bromberg, Stephen Lepp, 
Elton Hughes, Eric Christensen, Vulinh Nguyen, Mark Rau, Abdulhaf, Nathan Oliphant, 
Michael Bradly, Alex Darrow, Michael Fischer, Sarah Nottingham, Tim Allen, Bob Thomas, and 
Mike Bibby (the first). 


*The large number of acknowledgments is because we're testing the theory that everyone mentioned in 
a book acknowledgment will buy at least one copy, probably more, what with relatives and everything. If 
you'd like to be in the acknowledgment of our next book, and you have a large family, write to us. 
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1 dive in: a quick dip 


Breaking the Surface 


Come on, the 
water's great! We'll 
dive right in and write some code, 
then compile and run it. We're 

talking syntax, looping and branching, 
and a look at what makes Java so 
cool. You'll be coding in no 
time. 


Java takes you to new places. From its humble release to the public as the (wimpy) 
version 1.02, Java seduced programmers with its friendly syntax, object-oriented features, memory 
management, and best of all—the promise of portability. The lure of write-once/run-anywhere 
is just too strong. A devoted following exploded, as programmers fought against bugs, limita- 

tions, and, oh yeah, the fact that it was dog slow. But that was ages ago. If you're just starting in 

Java, you’re lucky. Some of us had to walk five miles in the snow, uphill both ways (barefoot), to 
get even the most trivial application to work. But you, why, you get to ride the sleeker, faster, 
easier-to-read-and-write Java of today. 
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the way Java works 


The way Java works 


The goal is to write one application (in this 
example, an interactive party invitation) and have 
it work on whatever device your friends have. 


source code for 


the interactive 


party invitation. 


Source 


Create a source 
document. Use an 
established protocol 
(in this case, the Java 
language). 
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0 aload.0 
4 invokespedial 
#1 <Method jav@ 


fang. Object Pp 


Compiler 


2 | 


Run your document 
through a source code 
compiler. The compiler 
checks for errors and 
won't let you compile 
until it’s satisfied that 
everything will run 
correctly. 


Method Party() 


0 aload_0 


1 invokespecial # 
<Method java.lang. 
Object()> 


4 return 


Output 
(code) 


Q 


The compiler creates a 
new document, coded 
into Java bytecode. 

Any device capable of 
running Java will be able 
to interpret/translate 
this file into something 
it can run. The compiled 
bytecode is platform- 
independent. 


Virtual 
Machines 


O 


Your friends all have a 
Java virtual machine 
(JVM), implemented in 
software, running inside 
their electronic gadgets. 
When your friends run 
your program, the virtual 
machine reads and runs 
the bytecode. 


What you'll do in Java 


You'll type a source code file, compile it using 
the javac compiler, and then run the compiled 
bytecode on a Java virtual machine. 


import java.awt.*; 
import java.awt.event.*; 


Class Party { 

public void buildInvite() { 
Frame f = new Frame(); 
Label | = new Label("Party at Tim's"); 
Button b = new Button("You bet"); 
Button c = new Button("Shoot me"); 
Panel p = new Panel(); 

p.add(|); 

} / more code here... 


} 


Source 


Type your source code. 


Save as: Party.java 


File Edit Window Help Plead 


Method Party() 
0 aload_0 


%javac Party. java 


1 invokespecial #1 <Method 
java.lang.Object()> 


4 return 


Method void buildInvite() 
Compiler 


0 new #2 <Class java.awt.Frame> 


Q m 
4 invokespecial #3 <Method 


java.awt.Frame()> 


Compile the Party.java 
file by running javac 
(the compiler application). 
If you don't have errors, 
you'll get a second docu- 
ment named Party.class. 


Output 
(code) 


Q 


Compiled code: Party.class 


The compiler-generated 
Party.class file is made up 
of bytecodes. 


(Note: this is NOT meant to be a tutorial... 


or now, We jus 


you Il be eA es 
wan 
how it all +i 


Code i moment, byt 
ee a tS ak bet fa 
together. 


In oth ds, the code on thi isn't 
quite real; don't bey grate ag Sn 
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%java Party 


e090 


Party at Tim's! 


Ee shoot ve) 


Virtual 
Machines 


O 


Run the program by 
starting the Java Virtual 
Machine (JVM) with the 
Party.class file. The JVM 
translates the bytecode 
into something the 
underlying platform 
understands, and runs 
your program. 
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history of Java 


A very brief history of Java 


Java was initially released (some would say “escaped”), on January 23, 1996. It’s over 25 years old! In 
the first 25 years, Java as a language evolved, and the Java API grew enormously. The best estimate we 
have is that over 17 gazillion lines of Java code have been written in the last 25 years. As you spend time 
programming in Java, you will most certainly come across Java code that’s quite old, and some that’s 
much newer. Java is famous for its backward compatibility, so old code can run quite happily on new 


JVMs. 


In this book we’ll generally start off by using older coding styles (remember, you’re likely to encounter 
such code in the “real world”), and then we'll introduce newer-style code. 


In a similar fashion, we will sometimes show you older classes in the Java API, and then show you 
newer alternatives. 


I've heard that 
Java isn't very fast 
compared to compiled 
languages like C and 
Rust. 


Speed and memory usage 


When Java was first released, it was slow. But soon after, the 
HotSpot VM was created, as were other performance enhanc- 
ers. While it’s true that Java isn’t the fastest language out there, 
it’s considered to be a very fast language—almost as fast as 
languages like C and Rust, and much faster than most other 
languages out there. 


Java has a magic super-power—the JVM. The Java Virtual 
Machine can optimize your code while it’s running, so it’s possible 
to create very fast applications without having to write special- 
ized high-performance code. 


But—full disclosure—compared to C and Rust, Java uses a lot 
of memory. 
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G harpen your pencil 
Look how easy it DN ——> Answers on page 6. 
is to write Java Try to guess what each line of code is doing... 


(answers are on the next page). 


int size = 27; declare an integer variable named ‘size’ and give it the value 27 


String name = "Fido"; 


Dog myDog = new Dog(name, size); 


size — 5; 


TE tes 15) myDog: PATKE); if x (value of 22) is less than 15, tell the dog to bark 8 times 


while (x > 3) { 


myDog.play(); 


int[] numList = {2, 4, 6, 8}; 


System.out.print ("Hello"); 


print out “Hello”... probably at the command line 


System.out.print ("Dog: " + name); 


String num = "8"; 


int z = Integer.parselInt (num); 


try { 


readTheFile("myFile.txt"); 


} 


catch (FileNotFoundException ex) { 


System.out.print ("File not found."); 


1.x because new versions are backward compatible, all the 
way back to 1.0. 

However, it was a bit confusing having a version number 
that was different to the name everyone used, so the 
official version number from Java 9 onward is just the 
number, without the “1” prefix; i.e., Java 9 really is version 
9, not version 1.9. 

In this book we'll use the common convention of 1.0-1.4, 
then from 5 onward we'll drop the “1” prefix. 

Also, since Java 9 was released in September 2017, there's 


Q: The naming conventions for Java's versions are 
confusing. There was JDK 1.0, and 1.2, 1.3, 1.4, then a jump 
to J2SE 5.0, then it changed to Java 6, Java 7, and last time 
I checked, Java was up to Java 18. What’s going on? 


A: The version numbers have varied a lot over the last 
25+ years! We can ignore the letters (J2SE/SE) since these 


are not really used now. The numbers are a little more been a release of Java every six months, each with a new 


involved. “major” version number, so we moved very quickly from 9 
Technically Java SE 5.0 was actually Java 1.5. Same for 6 to 18! 


(1.6), 7 (1.7), and 8 (1.8). In theory, Java is still on version you are here > 5 
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Gdharpen your pencil answers 
A 


Look how easy it 
is to write Java 


int size = 27; 

String name = "Fido"; 

Dog myDog = new Dog (name, size); 
size = 5; 


if (x < 15) myDog.bark (8); 


while (x > 3) { 


myDog.play(); 


int[] numList = {2, 4, 6, 8}; 
System.out.print ("Hello"); 
System.out.print ("Dog: " + name); 
String num = "8"; 


int z = Integer.parselInt (num); 


try { 
readTheFile ("myFile.txt"); 
} 


catch (FileNotFoundException ex) { 


System.out.print ("File not found."); 
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Don’t worry about whether you understand any of this yet! 
Everything here is explained in great detail in the book (most 
within the first 40 pages). If Java resembles a language you've 
used in the past, some of this will be simple. If not, don’t worry 
about it. We'll get there... 


declare an integer variable named ‘size’ and give it the value 27 


declare a string of characters variable named ‘name’ and give it the value “Fido” 


declare a new Dog variable ‘myDog and make the new Dog using ‘name’ and ‘size’ 


subtract 5 from 27 (value of ‘size’) and assign it to a variable named ‘x’ 


if x (value of 22) is less than 15, tell the dog to bark 8 times 


keep looping as long as x is greater than 3... 


tell the dog to play (whatever THAT means to a dog...) 


this looks like the end of the loop -- everything in { } is done in the loop 


declare a list of integers variable ‘numList, and put 2,4,6,8 into the list. 


print out “Hello”... probably at the command line 


print out “Dog: Fido” (the value of ‘name’ is Fido”) at the command line 


declare a character string variable ‘num’ and give it the value of “8” 


convert the string of characters “8” into an actual numerit value 8 


try to do something...maybe the thing we're trying isn’t guaranteed to work... 


vead a text file named “myFiletxt” (or at least TRY to read the file...) 


must be the end of the “things to try’, so | guess You tould try many things... 


this must be where you find out if the thing you tried didn't work... 


if the thing we tried failed, print “File not found” out at the command line 


looks like everything in the { } is what to do if the ‘bry’ didn’t work... 


Code structure in Java 


method 1 


statement 


statement 
statement 


In a source file, put a class. 


In a class, put methods. 


In a method, put statements. 


What goes ina 
source file? 


A source code file (with the „java 
extension) typically holds one class 
definition. The class represents a 
piece of your program, although a 
very tiny application might need 
just a single class. The class must go 
within a pair of curly braces. 


What goes ina 
class? 


A class has one or more methods. 
In the Dog class, the bark method 
will hold instructions for how the 
Dog should bark. Your methods 
must be declared inside a class (in 
other words, within the curly braces 
of the class). 


What goes ina 
method? 


Within the curly braces of a 
method, write your instructions for 
how that method should be per- 
formed. Method code is basically a 
set of statements, and for now you 
can think of a method kind of like a 
function or procedure. 
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public class Dog { 


public class Dog { 


void bark() { 


method 


public class Dog { 
void bark() { 
statement1; 
statement2; 


} 


‘statements 
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a Java class 


Anatomy of a class 


When the JVM starts running, it looks for the class you give it at the command 
line. Then it starts looking for a specially written method that looks exactly like: 


public static void main (String[] args) { 
// your code goes here 
} 


Next, the JVM runs everything between the curly braces { } of your main 
method. Every Java application has to have at least one class, and at least one 
main method (not one main per class; just one main per application). 


This is a The name of Opening curly 
Public so everyone class (duh) this ¢lass brace of the class 
can access ! 


class My: eee This method must, be given 
The return type. an array of Strings, and the 


(We'll cover this void means theres The name of array wi 
m y will be called ‘aras 
one later.) no return value. his method a 


os ` 
Serrat ara) [| 
E e wn 


This says print to standard output 
(defaults to command line) 


PL closing brace of the main method 


Ba ove brace of the MyFirstApp class 


The String, you 
want to print 


Dont worry about memorizing anything right now... 
this chapter is just to get you started. 


8 chapter 1 


Writing a class with a mainQ 


In Java, everything goes in a class. You'll type your source code file (with a java 
extension), then compile it into a new class file (with a .class extension). When 
you run your program, you're really running a class. 


Running a program means telling the Java Virtual Machine (JVM) to “Load the 
MyFirstApp class, then start executing its main () method. Keep running 
til all the code in main is finished.” 


In Chapter 2, A Trip to Objectville, we go deeper into the whole class thing, but for 
now, the only question you need to ask is, how do I write Java code so that 
it will run? And it all begins with main(). 


The main() method is where your program starts running, 


No matter how big your program is (in other words, no matter how many classes 
your program uses), there’s got to be a main() method to get the ball rolling. 


© Save 


MyFirstApp. java 


2) Compile } 


javac MyFirstApp. java 


0: aload 0 

1: invokespecial #1 
Method java/ang/Object ."<init>": ()V 
4: 
public 
String[]); 


MyFirstApp.class 
— © Run 


%$ java MyFirstApp 


ic void main(java. lang. 


java MyFirstApp 


I Rule! 


The World 


public class MyFirstApp { 
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public static void main (String[] args) { 
System.out .println("I Rule!"); 
System.out .println("The World"); 


the compiler and the JVM 


Fireside Chats 


The Java Virtual Machine 

What, are you kidding? HELLO. I am Java. Pm 
the one who actually makes a program run. The 
compiler just gives you a file. That’s it. Just a file. 
You can print it out and use it for wallpaper, kin- 
dling, lining the bird cage, whatever, but the file 
doesn’t do anything unless I’m there to run it. 


And that’s another thing, the compiler has no 
sense of humor. Then again, if you had to spend 
all day checking nitpicky little syntax violations... 


Pm not saying you’re, like, completely useless. But 
really, what is it that you do? Seriously. I have no 
idea. A programmer could just write bytecode by 
hand, and Id take it. You might be out of a job 
soon, buddy. 


(I rest my case on the humor thing.) But you still 
didn’t answer my question, what do you actually 


do? 


Tonight’s Talk: The compiler and 
the JVM battle over the question, 
“Who’s more important?” 


The Compiler 


I don’t appreciate that tone. 


Excuse me, but without me, what exactly would 
you run? There’s a reason Java was designed to use 
a bytecode compiler, for your information. If Java 
were a purely interpreted language, where—at 
runtime—the virtual machine had to translate 
straight-from-a-text-editor source code, a Java 
program would run at a ludicrously glacial pace. 


Excuse me, but that’s quite an ignorant (not to 
mention arrogant) perspective. While it zs true 
that—theoretically—you can run any properly 
formatted bytecode even if it didn’t come out of 

a Java compiler, in practice that’s absurd. A pro- 
grammer writing bytecode by hand is like paint- 
ing pictures of your vacation instead of taking 
photos—sure, it’s an art, but most people prefer to 
use their time differently. And I would appreciate 
it if you would not refer to me as “buddy.” 


Remember that Java is a strongly typed language, 
and that means I can’t allow variables to hold data 
of the wrong type. This is a crucial safety feature, 
and I’m able to stop the vast majority of viola- 
tions before they ever get to you. And I also— 


The Java Virtual Machine 


But some still get through! I can throw ClassCast- 
Exceptions and sometimes I get people trying to 
put the wrong type of thing in an array that was 
declared to hold something else, and— 


OK. Sure. But what about security? Look at all the 
security stuff I do, and you’re like, what, checking 
for semicolons? Oooohhh big security risk! Thank 
goodness for you! 


Whatever. I have to do that same stuff too, though, 
just to make sure nobody snuck in after you and 
changed the bytecode before running it. 


Oh, you can count on it. Buddy. 


dive in: a quick dip 


The Compiler 


Excuse me, but I wasn’t done. And yes, there are 
some datatype exceptions that can emerge at 
runtime, but some of those have to be allowed to 
support one of Java’s other important features — 
dynamic binding. At runtime, a Java program can 
include new objects that weren’t even known to the 
original programmer, so I have to allow a certain 
amount of flexibility. But my job is to stop any- 
thing that would never—could never—succeed at 
runtime. Usually I can tell when something won’t 
work, for example, if a programmer accidentally 
tried to use a Button object as a Socket connec- 
tion, I would detect that and thus protect them 
from causing harm at runtime. 


Excuse me, but I am the first line of defense, as 
they say. The datatype violations I previously 
described could wreak havoc in a program if they 
were allowed to manifest. I am also the one who 
prevents access violations, such as code trying to 
invoke a private method, or change a method 
that—for security reasons—must never be 
changed. I stop people from touching code they’re 
not meant to see, including code trying to access 
another class’ critical data. It would take hours, 
perhaps days even, to describe the significance of 
my work. 


Of course, but as I indicated previously, if I didn’t 
prevent what amounts to perhaps 99% of the po- 
tential problems, you would grind to a halt. And it 
looks like we’re out of time, so we’ll have to revisit 
this in a later chat. 
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statements, looping, branching 


What can you say in the main method? 


Once you're inside main (or any method), the fun begins. 
You can say all the normal things that you say in most 
programming languages to make the computer do 
something. 


Your code can tell the JVM to: 


@ do something 


Statements: declarations, assignments, 
method calls, etc. 


int x = 3; 

String name = "Dirk"; 

x = x * 17; 
System.out.print("x is " + x); 


double d = Math.random(); 
// this is a comment 


2] do something again and again 


Loops: for and while 


while (x > 12) { 
x= x = l; 


} 
for {int i = 0y 2 <. 10% is i + 1) 4 


System.out.print("i is now " + i); 


} 


© do something under this condition 


Branching: if/else tests 
if (x == 10) { 
System.out.print ("x must be 10"); 


System.out.print("x isn't 10"); 


if ((x < 3) && (name.equals("Dirk"))) { 


System.out.println ("Gently"); 


System.out.print ("this line runs no matter what"); 
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™% Each statement must end ina 
semicolon. 


x + l} 


# A single-line comment begins 
with two forward slashes. 


// this line disturbs me 


% Most white space doesn’t matter. 
3 


ri 


# Variables are declared with a 
name and a type (you'll learn about 
all the Java types in Chapter 3). 


int weight; 


//type: int, name: weight 


# Classes and methods must be 
defined within a pair of curly braces. 


public void go() { 
// amazing code here 


} 


dive in: a quick dip 


while (moreBalls == true) { 


j keepJuggling(); 


9 
Looping and looping and... 


Java has a lot of looping constructs: while, do-while, 
and for, being the oldest. You'll get the full loop scoop 
later in the book, but not right now. Let’s start with 
while. 


The syntax (not to mention logic) is so simple you’re 
probably asleep already. As long as some condition is 
true, you do everything inside the loop block. The loop 
block is bounded by a pair of curly braces, so whatever 
you want to repeat needs to be inside that block. 


The key to a loop is the conditional test. In Java, a 
conditional test is an expression that results in a boolean 
value—in other words, something that is either true 
or false. 


If you say something like, “While iceCreamInT he Tub 

1s true, keep scooping,” you have a clear boolean test. 
There either zs ice cream in the tub or there isn’t. But 

if you were to say, “While Bob keep scooping,” you 
don’t have a real test. To make that work, you’d have to 
change it to something like, “While Bob is snoring...” 
or “While Bob 1s not wearing plaid...” 


Simple boolean tests 


You can do a simple boolean test by checking the value 
of a variable, using a comparison operator like: 


< (less than) 
> (greater than) 


== (equality) (yes, that’s wo equals signs) 
Notice the difference between the assignment operator 
(a single equals sign) and the equals operator (two equals 
signs). Lots of programmers accidentally type = when 
they want ==. (But not you.) 
int x = 4; // assign 4 to x 
while (x > 3) { 
// loop code will run because 
// x is greater than 3 
x = x - 1; // or we'd loop forever 
} 
int z = 27; // 
while (z == 17) { 
// loop code will not run because 


// z is not equal to 17 
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Java basics 


Dini > Questions Example of a while loop 


public class Loopy { 


+ Why does everything have public static void main(String[] args) { 
to be in a class? 


int x = 1; 
System.out.printin("Before the Loop"); 
A: Java is an object-oriented while da< 4) 
(OO) language. It’s not like the System.out.println("In the loop"); 
old days when you had steam- System.out.printin("Value of x is " + x); 


driven compilers and wrote one 
monolithic source file with a pile 
of procedures. In Chapter 2, A Trip 


x =x +1; 


} 


to Objectville, you'll learn that a System.out.printin("This is after the loop"); 
class is a blueprint for an object, } 
and that nearly everything in Java } 
is an object. Thi 
r IS is th 
% java Loopy € output 
+ Dol have to put a main in Before the Loop a 
every class | write? In the loop 
Value of x is 1 
A: In the loop 
-+ Nope. A Java program 


: Value of x is 2 
might use dozens of classes (even 


hundreds), but you might only In the loop 


have one with a main method— Value of x is 3 

the one that starts the program This is after the loop 
running. 

Q: In my other language I can 

do a boolean test on an integer. BULLET POINTS 

In Java, can I say something like: L Statements end in a semicolon À 


APE = Code blocks are defined by a pair of curly braces { } 


while (x){ } 
= Declare an int variable with a name and a type: int x; 


: i ; ; — 
A: Re. A boolanandian The assignment operator is one equals sign 


integer are not compatible types in = The equals operator uses two equals signs == 
Java. Since the result of a condi- 
tional test must be a boolean, the = Awhile loop runs everything within its block (defined by curly 
only variable you can directly test braces) as long as the conditional test is true. 
(without using a comparison op- P f f 
erator) is a boolean. For example, = If the conditional test is false, the while loop code block won't 
you can Say: run, and execution will move down to the code immediately 
boolean istot = true; after the loop block. 
while(isHot) { } = Puta boolean test inside parentheses: 

while (x == 4) { } 


14 chapter 1 


Conditional branching 


In Java, an if test is basically the same as the boolean test in a while 
loop—except instead of saying, “while there’s still chocolate,” 
you'll say, “if there’s still chocolate...” 


class IfTest { 

public static void main (String[] args) { 
int x = 3; 
if (x == 3) { 

System.out.println("x must be 3"); 


} 


System.out.printlin("This runs no matter what"); 


C. 
% java IfTest ode output 
x must be 3 


This runs no matter what 


The preceding code executes the line that prints “x must be 3” only if 
the condition (x is equal to 3) is true. Regardless of whether it’s true, 
though, the line that prints “This runs no matter what” will run. So 
depending on the value of x, either one statement or two will print 
out. 


But we can add an else to the condition so that we can say something 
like, “Jf there’s still chocolate, keep coding, else (otherwise) get more 
chocolate, and then continue on...” 


class IfTest2 { 
public static void main(String[] args) { 
2; 
3) { 
System.out.println("x must be 3"); 


int x = 
if (x == 
} else { 

System.out.println("x is NOT 3"); 
} 


System.out.printlin("This runs no matter what"); 


New output 
% java IfTest2 


x is NOT 3 e 


This runs no matter what 


dive in: a quick dip 


System.out.print VS. 
System.out.printlh 


If you've been paying attention (of 
course you have), then you've noticed us 
switching between print and printin. 


Did you spot the difference? 


System.out.printin inserts a newline 
(think of print/n as printnewline), while 
System.out.print keeps printing to 

the same line. If you want each thing 
you print out to be on its own line, use 
println. If you want everything to stick 
together on one line, use print. 


@e sharpen your pencil 
ere your p 


Given the output: 


% java DooBee 
DooBeeDooBeeDo 


Fill in the missing code: 


public class DooBee { 
public static void main(String[] args) { 


int x = 1; 

while (x < yf 
System.out. ("Doo"); 
System.out. ("Bee"); 
x= x+ 1; 

} 

if (x == yt 


System.out.print ("Do"); 


—— > Answers on page 25. 
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serious Java app 


Coding a serious business 
application 


Let’s put all your new Java skills to good use with something 
practical. We need a class with a main(), an int and a String 
variable, a while loop, and an if test. A little more polish, and 
you'll be building that business back-end in no time. But before 
you look at the code on this page, think for a moment about 
how you would code that classic children’s favorite, “10 green 
bottles.” 


public class BottleSong { 
public static void main(String[] args) { 
int bottlesNum = 10; 
String word = "bottles"; 


while (bottlesNum > 0) { 


if (bottlesNum == 1) { 
word = "bottle"; // singular, as in ONE bottle. 


System.out.printin(bottlesNum + " green " + word + ", hanging on the wall"); 
System.out.printlin(bottlesNum + " green " + word + ", hanging on the wall"); 
System.out.printin("And if one green bottle should accidentally fall,"); 
bottlesNum = bottlesNum - 1; 


if (bottlesNum > 0) { 
System.out .printin("There'll be " + bottlesNum + 
"green " + word + ", hanging on the wall"); 
} else { 
System.out .printin("There'1ll be no green bottles, hanging on the wall"); 
} // end else 
} // end while loop 
} // end main method 
} // end class 


thereareno 
There's still one little flaw in our pum Questions 
code. IC compiles and runs, but the 7 Didn't this use to be "99 Bottles of Beer"? 


output isn't 100% perfect. See if 
you can spot the flaw and fix it. 


Å: Yes, but Trisha wanted us to use the UK version of 
the song. If you'd prefer the 99 bottles version, take that as 
a fun exercise. 
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dive in: a quick dip 


Monday morning at Bob’s Java-enabled house 


Bob’s alarm clock rings at 8:30 Monday morning, just like every 
other weekday. But Bob had a wild weekend and reaches for the 
SNOOZE button. And that’s when the action starts, and the 
Java-enabled appliances come to life... 


Java inside 


First, the alarm clock sends a message to the coffee maker n e 


“Hey, the geek’s sleeping in again, delay the coffee 12 minutes.” 


The coffee maker sends a message to the Motorola™ toaster, 
“Hold the toast, Bob’s snoozing,” 


Java here too 
— 


- The alarm clock then sends a message to Bob’s 
y Android, “Call Bob’s 9 o’clock and tell him we’re 


Se running a little late.” 


Finally, the alarm clock sends a message to Sam’s 

(Sam is the dog) wireless collar, with the too- 

A Ll familiar signal that means, “Get the paper, but \ 
| ’ lk.” ) \ ar 

Java don’t expect a wa Gam : se 

has Y3 


toaster A few minutes later, the alarm goes off again. And again Bob hits SNOOZE and 
the appliances start chattering. Finally, the alarm rings a third 
time. But just as Bob reaches for the snooze button, the clock f 
sends the “jump and bark” signal to Sam’s collar. Shocked to 2 
full consciousness, Bob rises, grateful that his Java skills, and 
spontaneous internet shopping purchases, have enhanced the daily 
routines of his life. 


butter here 


K 


Just another wonderful morning in The Java-Enabled House. 


His toast is toasted. 


His coffee steams. 


His paper awaits. 


Could this story be true? Mostly, yes! There are versions of Java running in devices 
including cell phones (especially cell phones), ATMs, credit cards, home security 
systems, parking meters, game consoles and more—but you might not find a Java 
dog collar...yet. 


Java has multiple ways to use just a tiny part of the Java platform to run on smaller 
devices (depending upon the version of Java you're using). It’s very popular for loT 
(Internet of Things) development. And, of course, lots of Android development is 
done with Java and JVM languages. 
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let’s write a program 


Try my new 
phrase-o-matic and 
you'll be a slick talker 

just like the boss or those 
hotshots in marketing. 


public class PhraseOMatic { 
public static void main (String[] args) { 


(1) // make three sets of words to choose from. Add your own! 
String[] wordListOne = {"agnostic", "opinionated", 
"voice activated", "haptically driven", "extensible", 
"reactive", "agent based", "functional", "AI enabled", 
"strongly typed"}; 


String[] wordListTwo = {"loosely coupled", "six sigma", 
"asynchronous", "event driven", "pub-sub", "IoT", "cloud 
native", "service oriented", "containerized", "serverless", 
"microservices", "distributed ledger"}; 


String[] wordListThree = {"framework", "library", 
"DSL", "REST API", "repository", "pipeline", "service 
mesh", "architecture", "perspective", "design", 


OK, so the bottle song wasn’t really a 
serious business application. Still need 
something practical to show the boss? "orientation"}; 
Check out the Phrase-O-Matic code. 


// find out how many words are in each list 
2) int oneLength = wordListOne. length; 
int twoLength = wordListTwo. length; 
int threeLength = wordListThree.length; 


Mates es type this into an edito // generate three random numbers 
ever hit the ri word/ line—wrap ‘ let 3) java.util.Random randomGenerator = new java.util.Random(); 
a tring (a th return key When you i: int rand1 = randomGenerator.nextInt (oneLength) ; 
Won Compile e between “quot OPA Ai int rand2 = randomGenerator .nextInt (twoLength) ; 
his Page are wl pa hYPhens You see ' int rand3 = randomGenerator .nextInt (threeLength) ; 
> on 
n 2 don't hi the ee ĉan type them // b ild h 
Ou v n Ke : é how build a rase 
© closed a String, ie AFTER String ne wordListOne[rand1] + "" + 
wordListTwo[rand2] + " " + wordListThree[rand3] ; 


System.out .println ("What we need is a " + phrase); 


O // print out the phrase 


} 
} 
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Phrase-0-Matic 


How it works 


In a nutshell, the program makes three lists of words, then randomly picks one word from each 
of the three lists, and prints out the result. Don’t worry if you don’t understand exactly what’s 
happening in each line. For goodness sake, you’ve got the whole book ahead of you, so relax. 
This is just a quick look from a 30,000-foot outside-the-box targeted leveraged paradigm. 


4. The first step is to create three String arrays—the containers that will hold all the words. 
Declaring and creating an array is easy; here’s a small one: 


String[] pets = {"Fido", "Zeus", "Bin"}; 


Each word is in quotes (as all good Strings must be) and separated by commas. 


2 For each of the three lists (arrays), the goal is to pick a random word, so we have to know 
how many words are in each list. If there are 14 words in a list, then we need a random num- 
ber between 0 and 13 (Java arrays are zero-based, so the first word is at position 0, the second 
word position 1, and the last word is position 13 in a 14-element array). Quite handily, a Java 

array is more than happy to tell you its length. You just have to ask. In the pets array, we'd say: 


int x = pets.length; 


and x would now hold the value 3. 


3 e We need three random numbers. Java ships out of the box with several ways to generate 
random numbers, including java.util.Random (we will see later why this class name is prefixed 
with java.util). The next Int () method returns a random number between 0 and some-num- 
ber-we-give-it, not including the number that we give it. So we'll give it the number of elements 
(the array length) in the list we’re using. Then we assign each result to a new variable. We could 
just as easily have asked for a random number between 0 and 5, not including 5: 


int x = randomGenerator.nextInt (5) ; 


4, Now we get to build the phrase, by picking a word from each of the three lists and 
smooshing them together (also inserting spaces between words). We use the “+” operator, 
which concatenates (we prefer the more technical smooshes) the String objects together. To get an 
element from an array, you give the array the index number (position) of the thing you want by 
using: 

String s = pets[0]; // s is now the String "Fido" 


s=s+" "+ "is a dog"; // s is now "Fido is a dog" 


5 e Finally, we print the phrase to the command line and...voilà! We’re in marketing. 


dive in: a quick dip 


what we need 
here is a... 


extensible microser- 
vices pipeline 


opinionated loosely 
coupled REST API 


agent-based 
microservices library 


Al-enabled service 
oriented orientation 


agnostic pub-sub 
DSL 


functional loT 
perspective 
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exercise: Code Magnets 


20 


Output: 
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Code Magnets 


A working Java program is all scrambled up 
on the fridge. Can you rearrange the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 


J bleseate Wino: Heb Slegy 
% java Shufflel 


a-b c-d 


System.out.print("b c"); 


int x = 3; 


ae) ae 


—_——+ Answers on page 25. 


BE the Compiler 


Each of the Java files on this page 

. Pepresents a complete source file. 

= Your job is to play compiler and 

M determine whether each of these files 
\ will compile. If they won't 
compile, how would you 
fix them? 


> Answers on page 25. 


A 


class Exercisela { 
public static void main(String[] args) { 
int x = 1; 
while (x < 10) { 
if (x > 3) { 
System.out.println("big x"); 
} 
} 
} 
} 


dive in: a quick dip 


B 


public static void main(String [] args) { 
int x = 5; 
while (x>1) { 
x=x-1; 
if (x< 3) { 
System.out .println("small x"); 
} 
} 
} 


C 


class Exerciselc { 
int x = 5; 
while (x > 1) { 
x=x-1; 
if (x < 3) { 
System.out.println("small x"); 
} 
} 
} 
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puzzle: crossword 


JavaCrass 


Let's give your right brain something to do. 


It’s your standard crossword, but almost all 
of the solution words are from Chapter 1. 
Just to keep you awake, we also threw in 

a few (non-Java) words from the high-tech 
world. 


Across 

4. Command line invoker 

6. Back again? 

8. Can't go both ways 

9. Acronym for your laptop's power 
12. Number variable type 

13. Acronym for a chip 

14. Say something 

18. Quite a crew of characters 

19. Announce a new class or method 


21. What's a prompt good for? 


——————> Answers on page 26. 
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Down 


1. Not aninteger(or___ your boat) 
2. Come back empty-handed 

3. Open house 

5. ‘Things’ holders 

7. Until attitudes improve 

10. Source code consumer 

11. Can't pin it down 

13. Department for programmers and operations 
15. Shocking modifier 

16. Just gotta have one 

17. How to get things done 


20. Bytecode consumer 


Mixed 
Messages 


A short Java program is listed below. One block of the program 


is missing. Your challenge is to match the candidate block of 


code (on the left) with the output that you'd see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 


command-line output. 


class Test { 
public static void main(String [] args) 


int x = 0; 
int y = 0; 


while (x < 5) 


System.out.print (x + 
xX =x + 1l; 


{ 


Candidates: 


Ne cig 
Rees ez 
YS yor 2; 
isl yo 4) i 
y=y=- l; 
} 

= ig 
=y r žy 


Possible output: 


22 46 


Ll 34 59 


02 14 26 38 


02 14 36 48 


O@ ii Al 32 


di Ail 32 42 


OO ii 23 36 


02 14 25 36 


42 


53 


410 


47 


dive in: a quick dip 


———— Answers on page 26. 
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puzzle: Pool Puzzle 


66] Puzzle 


LEX Your job is to take code snippets from the 
/ Vy pool and place them into the blank 

Ue; lines in the code. You may not use the 
same snippet more than once, and 
you won't need to use all the snip- 
pets. Your goal is to make a class that 
will compile and run and produce the 
output listed. Don't be fooled—this one’s 
harder than it looks. 


————> Answers on page 26. 


Output 
% java PoolPuzzleOne 


a noise 
annoys 


an oyster 


Note: Each snippet 
from the pool can be 
used only once! 


x>3 
x<4 


System.out.print(” "); 
System.out.print("a"); 
System.out.print("n"); 
System.out.print("an"); 
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class PoolPuzzleOne { 


public static void main(String 


int x = 0; 


while ( 


[] args) 


if ( 


System. 


System 
System 


.out.print("noys "); 
.out.print("oise "); 
System.out.print(" oyster "); 
System.out.print("annoys"); 
System. 


out.println(); 


out.print("noise"); 


dive in: a quick dip 


Ro) class Exercisela { 
= public static void main(String [] args) { 
ee, C 4° O&S int x = 1; 
Exercise Solutions OA 
g, while ( x < 10 ) { . vent 
; x Ss x=xel; Add this line to pve 
Sharpen your pencil (from page 14) = Re a ia Micra 
mq § if (Sap ò Erun 
public class DooBee { A E A Syst t tintin ("bi Ny. 
public static void main(String[] args) { ee eS x); 
int x = 1; } 
while (x < 3) { } 
System. out .print ("Doo"); ne ; 
Aan Out rine Eea] } This will compile and run (no output), but 
x=x +1; } without a line added to the program, it 
} would run forever in an infinite while loop! 
if (x == 3) { 
System.out.print ("Do"); 
} 
} : 
, claration 
} class Exerciselb { &~ Needs a class de 
Code Magnets (from page 20) public static void main(String [] args) { 
class Shufflel { int x = 5; 
public static void main(String[] args) { while (x>1) { 
x=x- l; 
IERE i B if (x <3) { 
while (x > 0) { 
System.out.println("small x"); 
if (x > 2) { } 
System.out.print ("a"); } This file won't compile without a 
} } class declaration, and don't forget 
} the matching curly brace! 
x =x - 1; 
System.out.print("-"); 
if (x == 2) { J Needs a “main” 
System.out.print("b c"); class Exerciselc { 
} public static void main(String [] args) { 
int x = 5; 
LES Oe i) 4 while (x>1) { 
System.out.print ("qd"); 
i x=x- 1; 
x S=S xX = 7 
Í C if (x< 3) { 
} System.out.printin("small x"); 
} 
} % java Shufflel } The while loop code must be inside a 
a-b c-d } method. It can't just be hanging out 


} inside the class. 
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puzzle answers 


Pool Puzzle (from page 24) 


class PoolPuzzleOne { 
public static void main(String [] args) 
int x = 0; 


while ( x<4) { 


System.out.print("a"); 

if ( x < 1.) 4{ 
System.out.print(""); 

} 

System.out.print("n"); 


if (x>1) { 
System.out.print(" oyster"); 
X=X+2; 


if ( x == 1 ) { 
System.out.print("noys"); 


if (x<1) { 
System.out.print("oise"); 


System.out.printin(); 


x=x+1; 
} 


} | File Edit Window Help Cheat | 
%java PoolPuzzleOne 


a noise 
annoys 


an oyster 
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JavaCrass (from page 22) 


2 


{ 


Mixed 
Messages 


F| [Vv 
‘JAV A ‘Llolo P 
R wi o TI 
BIRIAINIC H a Dbe IV 
A T IN| T (0) A 
y L M| JR] F 
‘Styls/T/ElMlolju/T le RINT 
T A I| JA 
A I L| JB 
"SIT RIING| DEC |L JAR 
I R| E 
jc | 


class Test { 
public static void main(String 
int x = 0; 
int y = 0; 
while (x< 5) { 


| O 


System.out.print(x + Te p y +" "); 
x=x + 1; 


[] args) { 


Candidates: Possible output: 


22 46 


11 34 59 
VSP A; 
ee me 02 14 26 38 

y SW = ly 
} 02 14 36 48 
BS eo dl OO Wi Al se 2p 
y= ay th se 


We (eee) 4 11 21 32-42 53 


x= Se ap lp 
LEN ye SS OY ah 


00 1r 235 36 410 


} 02 14 25 36 47 


(from page 23) 


2 classes and objects 


A Trip to Objectville 


We're going to 
Objectville! We're 
leaving this dusty ol’ 
procedural town for good. 
T'll send you a postcard. 


| was told there would be objects. In Chapter 1, we put all of our code in 

the main() method. That’s not exactly object-oriented. In fact, that’s not object-oriented at 

all. Well, we did use a few objects, like the String arrays for the Phrase-O-Matic, but we didn’t 
actually develop any of our own object types. So now we've got to leave that procedural world 
behind, get the heck out of main(), and start making some objects of our own. We'll look at 
what makes object-oriented (OO) development in Java so much fun. We'll look at the difference 
between a class and an object. We'll look at how objects can give you a better life (at least the 
programming part of your life. Not much we can do about your fashion sense). Warning: once 


you get to Objectville, you might never go back. Send us a postcard. 
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once upon a time in Objectville 


Chair Wars 


(or How Objects Can Change Your Life) 


i, the spec 

nce upon a time in a software shop, two programmers 

were given the same spec and told to “build it.” The / 

Really Annoying Project Manager forced the two 

coders to compete, by promising that 

whoever delivers first gets a cool Aeron™ 

chair and adjustable height standing desk like 
all the Silicon Valley techies have. Laura, the 


procedural programmer, and Brad, the OO 
developer, both knew this would be a piece of 
cake. 


Laura, sitting at her (non-adjustable) desk, 
thought to herself, “What are the things this 
program has to do? What procedures do we 
need?” And she answered herself, “rotate 

and playSound.” So off she went to build the 
procedures. After all, what zs a program if not a 
pile of procedures? 


Brad, meanwhile, kicked back at the coffee shop 
and thought to himself, “What are the things in 
this program...who are the key players?” He first 
thought of The Shapes. Of course, there were 
other things he thought of like the User, the Sound, and the 
Clicking Event. But he already had a library of code for those 
pieces, so he focused on building Shapes. Read on to see how 
Brad and Laura built their programs, and for the answer to your 
burning question, “So, who got the Aeron and the desk?” 


3. 


as the chair 


At Laura’s desk At Brad’s laptop at the cafe 


As she had done a gazillion times before, Laura 
set about writing her Important Procedures. 


; ; Square 
She wrote rotate and playSound in no time. d 


Brad wrote a elass for each of the three shapes. 


rotate (shapeNum) { 
// make the shape rotate 360° 
} 
playSound (shapeNum) { 
// use shapeNum to lookup which 
// AIF sound to play, and play it 
} 
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rotate) 
II code to rotate a s 

} rotate() { Triangle 
II code to rotate a q 
playSound() { } 
II code to play the A 
f for a square 


rotate() { 

II code to rotate a triangle 

playSound() { } 
Il code to play the 
II for a circle 


playSound() { 
II code to play the AIF file 
y for a triangle 


Laura thought she'd nailed it. She could almost feel the 


rolled steel of the Aeron beneath her... 


But wait! There’s been a spec change. 


classes and objects 


“OK, technically you were first, Laura,” said the Manager, “but we have to add just one tiny 
thing to the program. It'll be no problem for crack programmers like you two.” 


“Tf I had a dime for every time Pve heard that one,” thought Laura, knowing that spec-change-no- 
problem was a fantasy. “And yet Brad looks strangely serene. What’s up with that?” Still, Laura held 
tight to her core belief that the OO way, while cute, was just slow. And that if you wanted to 
change her mind, you'd have to pry it from her cold, dead, carpal-tunnelled hands. 


others, a 
file. 


Back at Laura’s desk 


The rotate procedure would still work; the code used a 
lookup table to match a shapeNum to an actual shape 
graphic. But playSound would have to change. 


playSound(shapeNum) { 
// if the shape is not an amoeba, 
// use shapeNum to lookup which 
// AIF sound to play, and play it 
// else 
// play amoeba .mp3 sound 
} 
It turned out not to be such a big deal, but it still made 
her queasy to touch previously tested code. Of all 
people, she should know that no matter what the project 


manager says, the spec always changes. 


a what got added to the spec 


At Brad’s laptop at the beach 


Brad smiled, sipped his fruit frappe, and wrote one new 
class. Sometimes the thing he loved most about OO was 
that he didn’t have to touch code he’d already tested 
and delivered. “Flexibility, extensibility, ...” he mused, 
reflecting on the benefits of OO. 


Amoeba 


rotate() { 
II code to rotate an amoeba 


} 


playSound() { 
Il code to play the new 
// .mp3 file for an amoeba 


} 
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once upon a time in Objectville 


Laura delivered just moments ahead of Brad 


(Hah! So much for that foofy OO nonsense.) But the smirk on Laura’s face melted when the Really 
Annoying Project Manager said (with that tone of disappointment), “Oh, no, that’s not how the amoeba 
is supposed to rotate...” 


Turns out, both programmers had written their rotate code like this: 
1. determine the rectangle that surrounds the shape. / N 
2. calculate the center of that rectangle, and rotate the shape around that point. / \ 

But the amoeba shape was supposed to rotate around a point on one end, like a clock hand. 

“Tm toast,” thought Laura, visualizing charred Wonderbread™. “Although, hmmmm. I could just add 

another if/else to the rotate procedure and then just hard-code the rotation point code for the amoeba. 

That probably won’t break anything.” But the little voice at the back of her head said, “Big Mistake. Do 

you honestly think the spec wont change again?” 


What the spec conveniently 
forgot to mention 


Back at Laura’s desk At Brad’s laptop on his lawn 
She figured she better add rotation point arguments chair at the Telluride Bluegrass Festival 


to the rotate procedure. A lot of code was affected. 
Testing, recompiling, the whole nine yards all over again. 
Things that used to work, didn’t. 


Without missing a beat, Brad modified the rotate 
method, but only in the Amoeba class. He never 
touched the tested, 


rotate(shapeNum, xPt, yPt) { working, compiled Amoeba 
if oe Se Sere not an Amoeba, code for the other parts of | int xPoint 
// calculate the center point . i : 
// based on a rectangle, the program. To give the int yPoint 
// then rotate Amoeba a rotation point, he | rotate() { 
// else added an attribute that all | // code to rotate an amoeba 
te Gee the ee and yPE Se Amoebas would have. He li using amoeba’s x and y 
// the rotation point offset . . } 
// and then rotate modified, tested, and deliv- 
} ered (via free festival WiFi) | playSound() { 


the revised program during | // code to play the new 
II .mp3 file for an amoeba 


} 


a single Bela Fleck set. 
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classes and objects 


So, Brad the 00 guy got the chair and desk, right? 


Not so fast. Laura found a flaw in Brad’s approach. And, 
since she was sure that if she got the chair and desk, she’d 
also be next in line for a promotion, she had to turn this thing 
around. 


LAURA: You’ve got duplicated code! The rotate procedure is 
in all four Shape things. 


BRAD: It’s a method, not a procedure. And they’re classes, 
not things. 


LAURA: Whatever. It’s a stupid design. You have to maintain 
Jour different rotate “methods.” How can that ever be good? 


BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Laura. 


What Laura really wanted > 


(figured the chair was a step closer 
to that promotion and the big bucks) 


| looked at what all four 
rotate() classes have in common. 


playSound() 4 


rotate() rotate() rotate() 
playSound() playSound() playSound() 


They’re Shapes, and they all rotate and 


playSound. Sol abstracted out the oar Q 
common features and put them into a playSound() 
new class called Shape. — Then | linked the other 
superclass four shape classes to 
p Ee Tile the new Shape class, 
in a relationship called 


inheritance. 
You can read this as, “Square inherits from Shape,” 


“Circle inherits from Shape,” and so on. | removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 


subelasses 


The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 
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once upon a time in Objectville 


What about the Amoeba rotate()? 


LAURA: Wasn’t that the whole problem here—that the amoeba shape had a 


completely different rotate and playSound procedure? 


BRAD: Method. 


LAURA: Whatever. How can Amoeba do something different if it 


“inherits” its functionality from the Shape class? 


BRAD: That’s the last step. The Amoeba class overrides the methods 


of the Shape class. Then at runtime, the JVM knows exactly which rotate() 
method to run when someone tells the Amoeba to rotate. 


superclass 
(more abstract) 


rotate() 
playSound() 


subclasses 
(more specific) 


LAURA: How do you “tell” an Amoeba to do 
something? Don’t you have to call the procedure, 
sorry —method, and then tell it which thing to 
rotate? 


BRAD: That’s the really cool thing about OO. 
When it’s time for, say, the triangle to rotate, the 
program code invokes (calls) the rotate() method 
on the triangle object. The rest of the program really 
doesn’t know or care how the triangle does it. 

And when you need to add something new to the 
program, you just write a new class for the new 
object type, so the new objects will have their 
own behavior. 
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I made the Amoeba class override 
the rotate() and playSound() 
methods of the superclass Shape. 


Overriding just means that a 
subclass redefines one of its 
inherited methods when it needs 
to change or extend the behavior 
of that method. 


rotate() { 

// amoeba-specific 

// rotate code oi 
i Overriding methods 

playSound() { a 

// amoeba-specific 

[| sound code } 


E 
can take care of 
myself. I know how 
an Amoeba is supposed to 
rotate and play a 
sound. 


I know how a Shape is 
supposed to behave. Your 
job is to tell me what to 
do, and my job is to make it happen. 
Don't you worry your little program- 
mer head about how T do it. 


O 


classes and objects 


The suspense is killing me. 
Who got the chair and desk? 


Amy from the second floor. 


(Unbeknownst to all, the Project 


Manager had given the spec to three 


programmers. Amy completed 


the project faster since she got on 


with OO programming without 
arguing with her co-workers). 


What do you like about 00? 


“It helps me design in a more natural way. Things 
have a way of evolving." 
-Joy, 27, software architect 


“Not messing around with code I've already 
tested, just to add a new feature.” 
-Brad, 32, programmer 


“I like that the data and the methods that oper- 
ate on that data are together in one class." 
-Jess, 22, foosball champion 


“Reusing code in other applications. When I write 
a new class, I can make it flexible enough to be 
used in something new, later." 

-Chris, 39, project manager 


“I can't believe Chris, who hasn't written a line of 
code in 5 years, just said that." 


-Daryl, 44, works for Chris 


“Besides the chair?” 
-Amy, 34, programmer 


Qe RAIN 
POWER 
Time to pump some neurons. 


You just read a story about a procedural 
programmer going head-to-head with an OO 
programmer. You got a quick overview of some 
key OO concepts including classes, methods, 
and attributes. We'll spend the rest of the 
chapter looking at classes and objects (we'll 
return to inheritance and overriding in later 
chapters). 


Based on what you've seen so far (and what you 
may know from a previous OO language you've 
worked with), take a moment to think about 
these questions: 


What are the fundamental things you need to 
think about when you design a Java class? What 
are the questions you need to ask yourself? 

If you could design a checklist to use when 
you're designing a class, what would be on the 
checklist? 


metacognitive tip 


If you’re stuck on an exercise, try talking about 
it out loud. Speaking (and hearing) activates 


a different part of your brain. Although it 
works best if you have another person to 
discuss it with, pets work too. That’s how 

our dog learned polymorphism. 
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thinking about objects 


When you design a class, think about the objects that 
will be created from that class type. Think about: 


E things the object knows 
E things the object does 


cartContents knows ae 
color 
setColor! 

eli does rer 


removeFromCart() 


checkOut() push() 


release() 


Things an object knows about itself are called 


alarmTime 


knows alarmMode knows 


setAlarmTime() 

does getAlarmTime() does 
isAlarmSet() 
snooze() 


E instance variables instance 
variables knows 
(state) 
, : tTitl 
Things an object can do are called methods | cctartcty fies 
(behavior) play() 
E methods 


Things an object knows about itself are called instance 
variables. ‘They represent an object’s state (the data) and can 
have unique values for each object of that type. 


Think of instance as another way of saying object. 


Things an object can do are called methods. When you 
design a class, you think about the data an object will need to 
know about itself, and you also design the methods that operate 
on that data. It’s common for an object to have methods that 
read or write the values of the instance variables. For example, 
Alarm objects have an instance variable to hold the alarmTime, 
and two methods for getting and setting the alarmTime. 


So objects have instance variables and methods, but those 
instance variables and methods are designed as part of the 
class. 
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@edharpen your pencil 


Fill in what a television object 
might need to know and do. 


Television 


instance 
variables 


methods 


—-+ Yours to solve. 


classes and objects 


What’s the difference between 
a class and an object? 


A class is not an object 
(but it’s used to construct them) 


one class 


A class is a blueprint for an object. It tells 
the virtual machine how to make an object of that 
particular type. Each object made from that class 
can have its own values for the instance 
variables of that class. For example, 
many objects Y°" might use the Button class to make 
dozens of different buttons, and each 
button might have its own color, size, shape, 
label, and so on. Each one of these different 
buttons would be a button object. 


An object is like one entry in your contacts list. 


One analogy for classes and objects is your phone’s contact list. 
Each contact has the same blank fields (the instance variables). 
When you create a new contact, you are creating an instance 

(object), and the entries you make for that contact represent its 


' tate. 
Name Polly Morfism eens 


The methods of the class are the things you do to a particular 
Phone 295-0343 ___ contact; getName( ), changeName( ), setName() could all be 
eMail PU@wickedlysmart methods for class Contact. 


So, each contact can do the same things (getName( ), 
changeName(), etc.), but each individual contact knows things 
unique to that particular contact. 
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making objects 


Making your first object 


So what does it take to create and use an object? You need two classes. One class 
for the type of object you want to use (Dog, AlarmClock, ‘Television, etc.) and an- 
other class to test your new class. The fester class is where you put the main method, 
and in that main() method you create and access objects of your new class type. 
The tester class has only one job: to try out the methods and variables of your new 
object. 


From this point forward in the book, you'll see two classes in many of our 
examples. One will be the real class—the class whose objects we really want to use, 
and the other class will be the fester class, which we call <WhateverYourClassNamels> 
TestDrive. For example, if we make a Bungee class, we'll need a 
BungeeTestDrive class as well. Only the <SomeClassName>TestDrive 

class will have a main() method, and its sole purpose is to create objects of your 
new class (the not-the-tester class), and then use the dot operator (.) to access the 
methods and variables of the new objects. This will all be made stunningly clear by 
the following examples. No, really. 


class Dog { 
int size; 
String breed; 
String name; 


A method 
void bark) 1 — 


System.out.printin("Ruff! Ruff!"); 


The Dot Operator (.) 


The dot operator (.) gives 
you access to an object's 
state and behavior (instance 
variables and methods). 


// make a new object 


Dog d = new Dog(); 


// tell it to bark by using the 
// dot operator on the 
// variable d to call bark() 


d.bark(); 


// set its size using the 
// dot operator 


d.size = 40; 


} 2) Write a tester (TestDrive) class 
exh a class DogTestDrive { 
Just 2 mâ Lode public static void main(String[] args) { 
ee Opn x ak ke? // Dog test code goes here 
pe 4m the © } 


In your tester, make an object and access 
the object's variables and methods 


class DogTestDrive { 
public static void main(String[] args) { 
Dog d = new Dog(); <— Mak 
d.size = 40; TAEA € a Dog object 
Dor a. bark (); K e the dot operator (.) 
gen A to set the size of the Do 


9 
, and to call its barkQ) method 
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If you already have some OO savvy, 


you'll know we're not using encapsulation. 


We'll get there in Chapter 4, How 
Objects Behave. 


Making and testing Movie objects 


class Movie { 


KILLER OBJECTS FROM 
OUTER SPACE 


The MovieTestDrive class creates objects (instances) of 


String title; 
String genre; 
int rating; 


void playIt () 


{ 


classes and objects 


System.out.printin("Playing the movie"); 


public static 
Movie one = 
one.title = 
one.genre = 


one.rating = 


Movie two = 
two.title 
two.genre = 


two.rating = 


public class MovieTestDrive { 


void main(String[] args) { 


new Movie () ; 


"Gone with the Stock"; 


"Tragic"; 
-2; 
new Movie () ; 


"Lost in Cubicle Space"; 


"Comedy"; 
5; 


two.playlIt () ; 


Movie three 
three.title 


= new Movie (); 
= "Byte Club"; 


three.genre = "Tragic but ultimately uplifting"; 
three.rating = 127; 


object 1 


object 2 


the Movie class and uses the dot operator (.) to set the 


instance variables to a specific value. The MovieTest- 


Drive class also invokes (calls) a method on one of the 
objects. Fill in the chart to the right with the values the 


three objects have at the end of main(). 


—> Yours to solve. 


object 3 


IN 


G harpen 0 


encil 


title 
genre 


rating 


title 
genre 


rating 


title 
genre 


rating 
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get the heck out of main 


Quick! Get out of main! 


As long as you’re in main(), you’re not really in Objectville. It’s fine for a test program 
to run within the main method, but in a true OO application, you need objects talk- 
ing to other objects, as opposed to a static main() method creating and testing objects. 


The two uses of main: 
E to test your real class 
E to launch/start your Java application 


A real Java application is nothing but objects talking to other objects. In this case, 
talking means objects calling methods on one another. On the previous page, and in 
Chapter 4, How Objects Behave, we look at using a main() method from a separate 
TestDrive class to create and test the methods and variables of another class. In 
Chapter 6, Using the Java Library, we look at using a class with a main() method to start 
the ball rolling on a real Java application (by making objects and then turning those 
objects loose to interact with other objects, etc.) 


As a “sneak preview,” though, of how a real Java application might behave, here’s a 
little example. Because we’re still at the earliest stages of learning Java, we’re work- 
ing with a small toolkit, so you'll find this program a little clunky and inefficient. You 
might want to think about what you could do to improve it, and in later chapters 
that’s exactly what we'll do. Don’t worry if some of the code is confusing; the key 
point of this example is that objects talk to objects. 


The Guessing Game 


Summary: 


The Guessing Game involves a game object and three player objects. The game gen- 
erates a random number between 0 and 9, and the three player objects try to guess 
it. (We didn’t say it was a really exciting game.) 


Classes: 


GuessGame.class Player.class GameLauncher.class 


The Logic: 
1. The GameLauncher class is where the application starts; it has the main() method. 


2. In the main() method, a GuessGame object is created, and its startGame() method 
is called. 


3. The GuessGame object's startGame() method is where the entire game plays out. It 
creates three players and then “thinks” of a random number (the target for the play- 
ers to guess). It then asks each player to guess, checks the result, and either prints 
out information about the winning player(s) or asks them to guess again. 
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main(String[] args 


GuessGame 


number 


classes and objects 


public class GuessGame { GuessGame has three instane 
Player pl; variables for the the PI e 
Player p2; £ objects. ee ayer 
Player p3; 
public void startGame() { Create th 
ree Player obi 
pl = new Player(); assi Y objects and 
p2 = new Player(); i wok them to the three Player 
p3 = new Player(); nstance variables. 
ane aueser t= 0; Declare three variables to held the 
int guessp2 = 0; three guesses the Players mak 
int guessp3 = 0; y e. 
an See - a <— ba three variables to hold a true or 
boolean p3isRight = false; alse based on the player's answer. Mak A ; 
ake 
int targetNumber = (int) (Math.random() * 10); e— th me ee number that 
System.out.printin("I'm thinking of a number between 0 and 9..."); € players ave to guess. 


wh 


} 
} // 
} //e 


ile (true) { 
System.out.prin 


pl.guess(); 
p2.guess(); 
p3.guess(); 


tln("Number to guess is " + targetNumber) ; 


4 — Call eath playev’s guess() method. 


guesspl = pl.number; 


System.out.prin 


guessp2 = p2.number; 


System.out.prin 


guessp3 = p3.number; 


System.out.prin 


tln("Player one guessed " + guessp1); 


Get each player’s guess (the result of the 
guess() method running) b cang the e 
number variable of each player. 


tln("Player two guessed " + guessp2); 


tln("Player three guessed " + guessp3); 


if (guesspl == targetNumber) { 
plisRight = true; 
} Check each player's Suess to see if it 
if (guessp2 == targetNumber) { matches the target number. |f a player is 
ener = ore right, then set that player’s variable to be 
E =e E E T rue (remember, we set it false by default). 
p3isRight = true; 
} 
if (plisRight || p2isRight || p3isRight) { oe. one OR player two OR player three is right 
System.out.println("We have a winner!"); e operator means OR) 
System.out.println("Player one got it right? " + plisRight); 
System.out.println("Player two got it right? " + p2isRight); 
System.out.printlin("Player three got it right? " + p3isRight); 
System.out.println("Game is over."); 
break; // game over, so break out of the loop 
} else { 
// we must keep going because nobody got it right! Otherwise stay i 
System.out.println("Players will have to try again."); Players fo). Y in he loop and 
} // end if/else another Guess, ask the 


// end loop 
end method 
nd class 
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Guessing Game 


Running the Guessing Game 


Output (it will be different each time you run it) 


% java GameLauncher 


I’m thinking of a number between 0 and 9... 


40 


-4 Java takes out the 
pay Garbage 


Each time an object is created 
in Java, it goes into an area of 
memory known as The Heap. All 
objects—no matter when, where, or how 
they’re created—live on the heap. But it’s 
not just any old memory heap; the Java 
heap is actually called the Garbage- 
Collectible Heap. When you create an 
object, Java allocates memory space on 
the heap according to how much that 
particular object needs. An object with, 
say, 15 instance variables, will probably 
need more space than an object with 
only two instance variables. But what 
happens when you need to reclaim 
that space? How do you get an object 
out of the heap when you're done with 
it? Java manages that memory for you! 
When the JVM can “see” that an object 
can never be used again, that object 
becomes eligible for garbage collection. 
And if you're running low on memory, 
the Garbage Collector will run, throw out 
the unreachable objects, and free up the 
space so that the space can be reused. 
In later chapters you'll learn more about 
how this works. 
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Number to guess is 7 

I’m guessing 1 

I’m guessing 9 

I’m guessing 9 

Player one guessed 1 

Player two guessed 9 

Player three guessed 9 
Players will have to try again. 
Number to guess is 7 

I’m guessing 3 

I’m guessing 0 

I’m guessing 9 

Player one guessed 3 

Player two guessed 0 

Player three guessed 9 
Players will have to try again. 
Number to guess is 7 

I’m guessing 7 

I’m guessing 5 

I’m guessing 0 

Player one guessed 7 

Player two guessed 5 

Player three guessed 0 

We have a winner! 

Player one got it right? true 


Player two got it right? false 


Player three got it right? false 


Game is over. 


there, are no 


Dumb Questions 


Q: What if I need global 
variables and methods? How 
do I do that if everything has to 
go in a class? 


Å: There isn't a concept of 
“global” variables and methods 
in a Java OO program. In 
practical use, however, there 
are times when you want a 
method (or a constant) to be 
available to any code running in 
any part of your program. Think 
of the random () method in 
the Phrase-O-Matic app; it’s a 
method that should be callable 
from anywhere. Or what about 
a constant like pi? You'll learn 

in Chapter 10 that marking 
amethod as public and 
static makes it behave much 
like a “global.” Any code, in any 
class of your application, can 
access a public static method. 
And if you mark a variable as 
public, static,and final, 
you have essentially made a 
globally available constant. 


Q: Then how is this object- 
oriented if you can still make 
global functions and global 
data? 


A: First of all, everything 

in Java goes in a class. So the 
constant for pi and the method 
for random (), although both 
public and static, are defined 
within the Math class. And you 
must keep in mind that these 
static (global-like) things are the 
exception rather than the rule 
in Java. They represent a very 
special case, where you don't 
have multiple instances/objects. 


Q: What is a Java program? 
What do you actually deliver? 


A: A Java program is a pile 
of classes (or at least one class). 
In a Java application, one of 

the classes must have a main 
method, used to start up the 
program. So as a programmer, 
you write one or more classes. 
And those classes are what you 
deliver. If the end user doesn’t 
have a JVM, then you'll also 
need to include that with your 
application's classes so that 
they can run your program. 
There are a number of 
programs that let you bundle 
your classes with a JVM and 
create a folder or file you can 
share however you want (e.g., via 
the internet). Then the end user 
can install the correct version 
of the JVM (assuming they don’t 
already have it on their machine). 


Q: What if I have a hundred 
classes? Or a thousand? Isn't 
that a big pain to deliver 

all those individual files? 

Can I bundle them into one 
Application Thing? 


A: Yes, it would be a big 

pain to deliver a huge bunch of 
individual files to your end users, 
but you won't have to. You can 
put all of your application files 
into a Java ARchive—a .jar file— 
that’s based on the pkzip format. 
In the jar file, you can include 

a simple text file formatted as 
something called a manifest, that 
defines which class in that jar 
holds the main () method that 
should run. 


AX) 


-—— BULLET POINTS 
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Vava is 
Pass | 
by value 


Wash, | 
‘at. | 
ca 


A class is likea recipe 


Objects are li 
l 
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Object-oriented programming lets you extend 
a program without having to touch previously 
tested, working code. 

All Java code is defined in a class. 

A class describes how to make an object of 
that class type. A class is like a blueprint. 
An object can take care of itself; you don’t 
have to know or care how the object does it. 
An object knows things and does things. 
Things an object knows about itself are called 
instance variables. They represent the state 
of an object. 

Things an object does are called methods. 
They represent the behavior of an object. 
When you create a class, you may also want 
to create a separate test class that you'll use 
to create objects of your new class type. 

A class can inherit instance variables and 
methods from a more abstract superclass. 
At runtime, a Java program is nothing more 
than objects “talking” to other objects. 
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exercise: Be the Compiler 


_. BE the Compiler 
ff i, Each of the Java files on this page 
‘Aig. represents a complete source file. 
CN Your job is to play compiler and 
| determine whether each of 
these files will compile. 
If they won't compile, 
how would you fix them, 
and if they do compile, what 
would be their output? 


A B 


class StreamingSong { class Episode { 


String title; 
String artist; 
int duration; 


int seriesNumber; 
int episodeNumber; 


void skipIntro() { 
System.out .printl1n ("Skipping intro..."); 


void play() { 
System.out .println("Playing song"); 
} } 
void printDetails() { void skipToNext () { 
System.out .println("This is " + title + 
"by " + artist); } 


class EpisodeTestDrive { 


class StreamingSongTestDrive { public static void main(String[] args) { 


public static void main(String[] args) { 
Episode episode = new Episode (); 


episode.seriesNumber = 4; 
episode.play() ; 
episode.skipIntro() ; 


song.artist = "The Beatles"; 

song.title = "Come Together"; 

song.play(); 

song.printDetails (); ) } 
} 


—————> Answers on page 46. 
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System.out .printl1n ("Loading next episode.. 


")i 


classes and objects 


Code Magnets ————> Answers on page 46. 


A Java program is all scrambled up on 
the fridge. Can you reconstruct the 
d.playSnare(); 
DrumKit d = new DrumKit (); 


code snippets to make a working Java 
topHat = true; 


program that produces the output listed 
below? Some of the curly braces fell on 
the floor and they were too small to pick 
up, so feel free to add as many of those 
as you need. 


boolean 


e = true; 


poolean snar 


void playSnare() { 


System.out.print1n ("bang bang ba-bang"); 


public static void main(String [] args) { 


class DrumKit { 


void PlayTopHat O { 


System. out , 
: *Println("qj : 
Pine ding da-ding"); 


2 


% java DrumKitTestDrive 


bang bang ba-bang 


ding ding da-ding 
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puzzle: Pool Puzzle 


public class EchoTestDrive { 


public static void main(String [] 
args) { 


66] Puzzle Echo el = new Echo(); 


Your job is to take code snippets from 
the pool and place them into the 


int. x = 0; 


land while ( rf 

blank lines in the code. You may el.hello(); 

use the same snippet more than 

once, and you won't need to use F 

all the snippets. Your goal is to if (~) i 

make classes that will compile and e2.count = e2.count + 1; 

run and produce the output listed be- } 
low. Some of the exercises and puzzles i£ <( ) { 
in this book might have more than one e2.count = e2.count + el.count; 
correct answer. If you find another cor- 


} 
rect answer, give yourself bonus points! x=x+ l; 


} 


System.out.printin(e2.count) ; 
File Edit Window Help Implode } 
Sjava EchoTestDrive 


class { 


int = 0; 
void { 
Bonus Question ! System.out.println("helloooo... "); 
If the last line of output was } 


24 instead of 10, how would } 
you complete the puzzle? 


Note: Each snippet 
from the pool can be 
used more than once! 


Echo 


e2 x>0 Tester 

count x>1 echo() e2=el; 
ym el=el+i; count( ) Echo e2; 
el =count +1; hello() Echo e2 = e1; 


e1.count = count + 1; 


Echo e2 = new Echo( ); 
el.count = e1.count + 1; 
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—— Answers on page 47. 


| am compiled from a .java file. 


classes and objects 


A bunch of Java components, in full costume, are playing a party 
game, “Who am I?” They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be 
true for more than one of them, choose all for whom that sentence 
can apply. Fill in the blanks next to the sentence with the names of 
one or more attendees. The first one’s on us. 


Tonight's attendees: 


Class Method Object Instance variable 


elass 


My instance variable values can 
be different from my buddy’s 
values. 


| behave like a template. 


| like to do stuff. 


| can have many methods. 


| represent “state.” 


| have behaviors. 


| am located in objects. 


I live on the heap. 


| am used to create object instances. 


My state can change. 


| declare methods. 


| can change at runtime. 


—————> Answers on page 47. 
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exercise solutions 


Code Magnets (from page 43) 


class DrumKit { 
boolean topHat = true; 
boolean snare = true; 


void playTopHat() { 
System.out.println("ding ding da-ding") ; 


void playSnare() { 
System.out.printin("bang bang ba-bang") ; 


class DrumKitTestDrive { 
public static void main(String[] args) { 
DrumKit d = new DrumKit(); 
d.playSnare (); 
d.snare = false; 
d.playTopHat () ; 


if (d.snare == true) { 
d.playSnare(); 


File Edit Window Help Dance 


% java DrumKitTestDrive 


bang bang ba-bang 


ding ding da-ding 


46 chapter 2 


BE the Compiler (from page 42) 


class StreamingSong { 
String title; 
String artist; 
int duration; 


A void play() { 


System.out.println("Playing song"); 
} 


void printDetails() { 
System.out.println("This is " + title + 
"by " + artist); 


We've got the template, 


} have to make an object! edie 


class StreamingSongTestDrive { 
public static void main(String[] args) { 


StreamingSong song = new StreamingSong(); 
song.artist = "The Beatles"; 
song.title = "Come Together"; 
song.play(); 

song.printDetails(); 


class Episode { O; 
int seriesNumber; The line: episode Play L 3 lay 
int episodeNumber; a oldn t compile withou 


thod in the episode Class. 
void play() { me: 
System.out. printin("Playing episode ig episodeNuwiber); 


void skipIntro() { 
System.out.println ("Skipping intro..."); 
} 


void skipToNext() { 
System.out.println("Loading next episode..."); 


} 


B class EpisodeTestDrive { 
public static void main(String[] args) { 
Episode episode = new Episode(); 
episode.seriesNumber = 4; 
episode.play(); 
episode.skipIntro(); 


KE Puzzle Solutions 


Poo] Puzzle (from page 44) 


public class EchoTestDrive { 


public static void main(String[] 


args) { 
Echo el = new Echo(); 
Echo e2 = new Echo(); // correct answer 
- or - 
Echo e2 = e1; // bonus "24" answer 
int x = 0; 
while (x<4) { 


el.hello(); 
e1.count = e1.count + 1; 
if (x==3) { 
e2.count = e2.count + 1; 
} 
if (x>0) { 
e2.count = e2.count + el.count; 


} 
x =x +1; 
} 


System.out.printin(e2.count) ; 


class Echo { 
int count = 0; 


void hello() { 
System.out.printin("helloooo... "); 


File Edit Window Help Assimilate 


%java EchoTestDrive 


helloooo... 
helloooo... 
helloooo... 
helloooo... 
10 
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Who Am J? (from page 45) 


I am compiled from a .java file. 


My instance variable values can be 
different from my buddy’s values. 


| behave like a template. 

| like to do stuff. 

| can have many methods. 
| represent “state.” 

| have behaviors. 

| am located in objects. 

| live on the heap. 


| am used to create object 
instances. 


My state can change. 
| declare methods. 


| can change at runtime. 


class 


object 

elass 

object, method 

class, object 

instance variable 

object, class 

method, instance variable 
object 


class 
object, instance variable 
elass 


object, instance variable 


Note: both classes and objects are said to have state and behavior. 
They're defined in the class, but the object is also said to “have” 
them. Right now, we don't care where they technically live. 
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3 primitives and references 


Know Your Variables 


A «ocdefghijklmnopa s a T YZE 


i Declarations and Assignments. 
s 
C Siiki 
int x} 


fota = 3.1416; 


EE ET ES Ti 


long Y=x +3. 


Variables can store two types of things: primitives and references. 
So far you've used variables in two places—as object state (instance variables) and as local 
variables (variables declared within a method). Later, we'll use variables as arguments (values 
sent to a method by the calling code), and as return types (values sent back to the caller of the 
method). You've seen variables declared as simple primitive integer values (type int). You've 
seen variables declared as something more complex like a String or an array. But there’s gotta 
be more to life than integers, Strings, and arrays. What if you have a PetOwner object with a 

Dog instance variable? Or a Car with an Engine? In this chapter we'll unwrap the mysteries of Java 
types (like the difference between primited and references) and look at what you can declare as a 
variable, what you can putin a variable, and what you can do with a variable. And we'll finally see 


what life is truly like on the garbage-collectible heap. 
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declaring a variable 


Declaring a variable 


Java cares about type. It won’t let you do 
something bizarre and dangerous like stuff a 
Giraffe reference into a Rabbit variable—what 
happens when someone tries to ask the so-called 
Rabbit to hop () ? And it won’t let you put a 
floating-point number into an integer variable, 
unless you zell the compiler that you know you might 
lose precision (like, everything after the decimal 
point). 


The compiler can spot most problems: 
Rabbit hopper = new Giraffe(); 
Don’t expect that to compile. Thankfully. 


For all this type-safety to work, you must declare 

the type of your variable. Is it an integer? a Dog? 

A single character? Variables come in two flavors: 
primitive and object reference. Primitives hold 
fundamental values (think: simple bit patterns) 
including integers, booleans, and floating-point num- 
bers. Object references hold, well, references to objects 
(gee, didn’t that clear it up). 


We’ll look at primitives first and then move on 
to what an object reference really means. But 
regardless of the type, you must follow two 
declaration rules: 


variables must have a type 


Besides a type, a variable needs a name so that you 
can use that name in code. 


é an 
Variable & = variables must have a name 


int count; 


bye. ae 


Note: When you see a statement like: “an object of 
type X,” think of type and class as synonyms. (We’ll 
refine that a little more in later chapters.) 
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“I'd like a double mocha, no, make it an int.” 


When you think of Java variables, think of cups. Coffee cups, tea cups, giant cups 
that hold lots and lots of your favorite drink, those big cups the popcorn comes in 
at the movies, cups with wonderful tactile handles, and cups with metallic trim that 
you learned can never, ever go in the microwave. 


A variable is just a cup. A container. It holds something. 


It has a size and a type. In this chapter, we’re going to look first at the variables 
(cups) that hold primitives: then a little later we'll look at cups that hold references 
to objects. Stay with us here on the whole cup analogy—as simple as it is right 

now, it’ll give us a common way to look at things when the discussion gets more 
complex. And that'll happen soon. 


Primitives are like the cups they have at the coffee shop. If you’ve been to a 
Starbucks, you know what we’re talking about here. They come in different sizes, 
and each has a name like “short,” “tall,” and, “Td like a ‘grande’ mocha half-caff 


with extra whipped cream.” 
You might see the cups displayed on the counter so you 
can order appropriately: u 


small short tall grande 
And in Java, primitives come in different sizes, and those sizes have 
names. When you declare any variable in Java, you 
must declare it with a specific type. The four 
_ containers here are for the four integer 
p primitives in Java. 
long int short byte 


Each cup holds a value, so for Java primitives, rather than saying, “Td like a tall 
french roast,” you say to the compiler, “Pd like an int variable with the number 90 
please.” Except for one tiny difference...in Java you also have to give your cup a 
name. So it’s actually, “Td like an int please, with the value of 2486, and name the 
variable height.” Each primitive variable has a fixed number of bits (cup size). 
The sizes for the six numeric primitives in Java are shown below: 


sou 


byte short int long float double 
8 16 32 64 32 64 


primitives and references 


Primitive Types 
Type BitDepth Value Range 


boolean and char 


boolean (JVM-specific) true or false 
char 16 bits 0 to 65535 


numeric (all are signed) 


integer 

byte 8 bits -128 to 127 

short 16 bits -32768 to 
32767 

int 32 bits -2147483648 
to 2147483647 


long 64 bits -huge to huge 


floating point 


float 32 bits varies 
double 64bits varies 


Primitive declarations 


with assignments: 


int x; 

x = 234; 

byte b = 89; 

boolean isFun = true; 
double d = 3456.98; 
char c = ‘f’; 

int z = x; 

boolean isPunkRock; 
isPunkRock = false; 
boolean powerOn; 
powerOn = isFun; 
long big = 3456789L; 
float f = 32.5f; 


a ) 
Note the P and ‘Le wae 7 
some number types you A 
specifically tell the ae 
what you mean, OF ib mig a 
et tonfused between simi g 
ane number types: You 


use upper OF lowertase: 
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primitive assignment 


You really don't want to spill that... 


Be sure the value can fit into the variable. 


You can’t put a large value into a 
small cup. 


Well, OK, you can, but you'll lose 
some. You'll get, as we say, spillage. 
The compiler tries to help prevent 
this if it can tell from your code 
that something’s not going to fit in 
the container (variable/cup) you’re 
using. 

For example, you can’t pour an 
int-full of stuff into a byte-sized 
container, as follows: 


int x = 24; 
byte b = x; 


//won't work!! 


Why doesn’t this work, you ask? After all, the value of x 1s 24, and 24 is definitely small 
enough to fit into a byte. You know that, and we know that, but all the compiler cares 
about is that you’re trying to put a big thing into a small thing, and there’s the possibility 
of spilling. Don’t expect the compiler to know what the value of x is, even if you happen 
to be able to see it literally in your code. 


You can assign a value to a variable in one of several ways including: 
E type a Heral value after the equals sign (x=12, isGood = true, etc.) 
E assign the value of one variable to another (x = y) 
E use an expression combining the two (x = y + 43) 


In the examples below, the literal values are in bold italics: 


int size = 32; declare an int named size, assign it the value 32 

char initial = 'j'; declare a char named initial, assign it the value f’ 
double d = 456.709; declare a double named d, assign it the value 456.709 
boolean isLearning; declare a boolean named isCrazy (no assignment) 
isLearning = true; assign the value true to the previously declared isCrazy 
int y = x + 456; declare an int named y, assign it the value that is the sum 


of whatever x is now plus 456 
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Ge sharpen your pencil 
eer your p 


The compiler won't let you put 
a value from a large cup into 

a small one. But what about 
the other way—pouring a 
small cup into a big one? No 
problem. 


Based on what you know 
about the size and type of the 
primitive variables, see if you 
can figure out which of these 
are legal and which aren't. 
We haven't covered all the 
rules yet, so on some of these 
you'll have to use your best 
judgment. Tip: The compiler 
always errs on the side of 
safety. 


From the following list, Circle 
the statements that would be 
legal if these lines were in a 

single method: 


. int x = 34.5; 


- boolean boo 


. int g 17; 


. int y 


. byte b 


. byte v 


10. short 


11. v = n; 


12. byte k = 128; 


——> Answers on page 68. 


primitives and references 


Back away from that keyword! 


You know you need a name and a type for your variables. 
You already know the primitive types. 


But what can you use as names? The rules are simple. 
You can name a class, method, or variable according to the 
following rules (the real rules are slightly more flexible, but 

these will keep you safe): 


E It must start with a letter, underscore (_), or 
dollar sign ($). You can’t start a name with a 


number. 
oni 
E After the first character, you can use numbers as And here's 4 mne ee Larg 
well. Just don’t start it with a number. full Bears Shouldnt ng 
Caretul: 
E It can be anything you like, subject to those two B Dogs ick even better. 
rules, just so long as it isn’t one of Java’s reserved Furry wn, it'll stl 


ou 
words. jf you make uY 
y s Ll F_ D 
Reserved words are keywords (and other things) that the compiler Bee Bae 
recognizes. And if you really want to play confuse-a-compiler, then 


just try using a reserved word as a name. 


No matter what 
you hear, do not, I 
repeat, do not let me 
ingest another large 
furry dog. 


don %4 
You’ve already seen some reserved words: to use 3 
r nY o f 
ma Your ow y th ês 
h nam e 


public static void 


And the primitive types are reserved as well: 


boolean char byte short int long float double 


But there are a lot more we haven’t discussed yet. Even if you don’t 

need to know what they mean, you still need to know you can’t use *em 
yourself. Do not—under any circumstances—try to memorize these 
now. ‘To make room for these in your head, you’d probably have to lose 
something else. Like where your car is parked. Don’t worry, by the end of 
the book you'll have most of them down cold. 


This table reserved 


asser [ess [enum [gore [iong [pube | srehronized [void | 
boye [oetan [nat [import [nal [static [throws |__| 
[ease [ao [finaly [instanceof [package [atrctfp [transis |_| 


Java’s keywords, reserved words, and special identifiers. If you use these for names, the compiler will probably be very, very upset. 
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object references 


Controlling your Dog object 


You know how to declare a primitive variable and assign it a value. 
But now what about non-primitive variables? In other words, what 


about objects? Dog d = new Dog(); 
d.bark(): 


™ There is actually no such thing as an object variable. 


E There’s only an object reference variable. think of this 


E An object reference variable holds bits that represent a lik hi 
way to access an object. Ke 1S 


E It doesn’t hold the object itself, but it holds something 
like a pointer. Or an address. Except, in Java we don’t 
really know whatis inside a reference variable. We do 
know that whatever it is, it represents one and only one 
object. And the JVM knows how to use the reference to 
get to the object. 


You can’t stuff an object into a variable. We often think of it that 
way...we say things like, “I passed the String to the System.out. 
println() method.” Or, “The method returns a Dog” or, “I put a new 
Foo object into the variable named myFoo.” 


But that’s not what happens. There aren’t giant expand- 
able cups that can grow to the size of any object. 


Think of a Dog 


Objects live in one place and one place only—the | referente variable as 


garbage-collectible heap! (You'll learn more about 


that later in this chapter) a Dog remote control. 


bà You use it to get the 
- object to do something 
(invoke methods). 


Although a primitive variable is full of bits 
representing the actual value of the variable, 
an object reference variable is full of bits 
representing a way to get to the 
object. 


You use the dot operator (.) on a ref- 
erence variable to say, “use the thing 
before the dot to get me the thing after 
the dot.” For example: 


myDog. bark () ; 


means, “use the object referenced by the variable myDog to invoke 
the bark() method.” When you use the dot operator on an object 
reference variable, think of it like pressing a button on the remote 
control for that object. 
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sou 


byte short int long reference 


8 lb 32 64 (bit depth not relevant) 


An object reference is just 
another variable value 


Something that goes in a cup. 
Only this time, the value is a remote control. 


Primitive Variable o> 
— . $ 
byte -= di primitive 
The bits representing 7 go value 
into the variable (00000111). 
byte 

Reference Variable 5 

v 
Dog myDog = new Dog (); Dog” 
The bits representing a way to get to 4 K 
the Dog object go into the variable. referente 
The Dog object itself does not go into value 


the variable! 


With primitive variables, the value of the vari- 
able is...the value (5, -26.7, ʻa’). 


With reference variables, the value of the 
variable is...bits representing a way to get to a 
specific object. 


You don’t know (or care) how any particular 
JVM implements object references. Sure, they 
might be a pointer to a pointer to...but even 
if you know, you still can’t use the bits for 
anything other than accessing an object. 


We don’t care how many 1s and Os there are in a reference variable. It’s 
up to each JVM and the phase of the moon. 


primitives and references 


The 3 steps of object 
declaration, creation and 


assignment 
1 2 
Dog myDog = new Dog(); 


Declare a reference 
variable 


Dog myDog = new Dog(); 


Tells the JVM to allocate space for a 
reference variable, and names that 
variable myDog. The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button Dog 
or a Socket. 


2) Create an object 


Dog myDog = new Dog (); 


Tells the JVM to allocate space for a 
new Dog object on the heap (we'll 
learn a lot more about that process, 
especially in Chapter 9, Life and Death 


ofan Object). Dog object 


Link the object 
and the reference 


Dog myDog = new Dog(); 


Assigns the new Dog to the reference 
variable myDog. In other words, 
programs the remote control. 


Dog object 
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object references 


there, are_no 


Dumb Questions 


Q: How big is a reference 
variable? 


A: You don’t know. Unless 
you're cozy with someone on the 
JVM's development team, you 
don't know how a reference is 
represented. There are pointers 
in there somewhere, but you 
can’t access them. You won't 
need to. (OK, if you insist, you 
might as well just imagine it 

to be a 64-bit value.) But when 
you're talking about memory 
allocation issues, your Big 
Concern should be about how 
many objects (as opposed to 
object references) you're creating 
and how big they (the objects) 
really are. 


Q: So, does that mean that 

all object references are the 
same size, regardless of the size 
of the actual objects to which 
they refer? 


A: Yep. All references for a 
given JVM will be the same 


size regardless of the objects 
they reference, but each JVM 
might have a different way of 
representing references, so 
references on one JVM may be 
smaller or larger than references 
on another JVM. 


Q: Can | do arithmetic ona 
reference variable, increment 
it, you know—C stuff? 


A: Nope. Say it with me again, 
“Java is not C” 
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Java Exposed 


This week’s interview: 
Object Reference 


HeadFirst: So, tell us, what’s life like for an object reference? 


Reference: Pretty simple, really. Pm a remote control, and I can be programmed to 
control different objects. 


HeadFirst: Do you mean different objects even while you’re running? Like, can you 
refer to a Dog and then five minutes later refer to a Car? 


Reference: Of course not. Once I’m declared, that’s it. If Pm a Dog remote control, 
then PII never be able to point (oops—mny bad, we’re not supposed to say poini), I mean, 
refer to anything but a Dog. 

HeadFirst: Does that mean you can refer to only one Dog? 


Reference: No. I can be referring to one Dog, and then five minutes later I can refer to 
some other Dog, As long as it’s a Dog, I can be redirected (like reprogramming your remote 
to a different TV) to it. Unless...no never mind. 


HeadFirst: No, tell me. What were you gonna say? 


Reference: I don’t think you want to get into this now, but PII just give you the short 
version—1if I’m marked as final, then once I am assigned a Dog, I can never be repro- 
grammed to anything else but that one and only Dog, In other words, no other object can 
be assigned to me. 


HeadFirst: You're right, we don’t want to talk about that now. OK, so unless you’re 
final, then you can refer to one Dog and then refer to a different Dog later. Can you ever 
refer to nothing at all? Is it possible to not be programmed to anything? 


Reference: Yes, but it disturbs me to talk about it. 

HeadFirst: Why is that? 

Reference: Because it means I’m nu11, and that’s upsetting to me. 
HeadFirst: You mean, because then you have no value? 


Reference: Oh, nu11 isa value. I’m still a remote control, but it’s like you brought 
home a new universal remote control and you don’t have a TV. I’m not programmed to 
control anything. They can press my buttons all day long, but nothing good happens. I 
just feel so...useless. A waste of bits. Granted, not that many bits, but still. And that’s not 
the worst part. If I am the only reference to a particular object and then I’m set to null 
(deprogrammed), it means that now nobody can get to that object I had been referring to. 


HeadFirst: And that’s bad because... 


Reference: You have to ask? Here I’ve developed a relationship with this object, an 
intimate connection, and then the tie is suddenly, cruelly, severed. And I will never see 
that object again, because now it’s eligible for [producer, cue tragic music] garbage collection. 
Sniff. But do you think programmers ever consider thal? Snif. Why, why can’t I be a primi- 
tive? I hate being a reference. The responsibility, all the broken attachments... 


primitives and references 


Life on the garbage-collectible heap 


Book b = new Book(); 


Book c = new Book(); 


Declare two Book reference 
variables. Create two new Book 
objects. Assign the Book objects to 
the reference variables. 


The two Book objects are now living 
on the heap. 


References: 2 
Objects: 2 


Book 


Book d = c; 


Declare a new Book reference variable. 
Rather than creating a new, third Book 
object, assign the value of variable c to 
variable d. But what does this mean? 

It's like saying “Take the bits in c, make a 
copy of them, and stick that copy into d.” 


Both c and d refer to the same 
object. 


The c and d variables hold 
two different copies of the 
same value. Two remotes 
programmed to one TV. 


References: 3 
Objects: 2 


c= b; 


Assign the value of variable 6 to 
variable c. By now you know what 
this means. The bits inside variable 
b are copied, and that new copy is 
stuffed into variable c. 


Both b and c refer to the 
same object. 


The c variable no longer 
refers to its old Book 
object. 


References: 3 
Objects: 2 
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objects on the heap 


Life and death on the heap 


Book b = new Book(); E 


Book c = new Book (); 


Declare two Book reference variables. 
Create two new Book objects. Assign 
the Book objects to the reference 
variables. 


The two book objects are now living 
on the heap. 


Active References: 2 
Reachable Objects: 2 


Book 


b = c; 


Assign the value of variable c to variable b. 
The bits inside variable ¢ are copied, and 
that new copy is stuffed into variable b. 
Both variables hold identical values. 


Both b and c refer to the same 
object. Object 1 is abandoned 
and eligible for Garbage Collec- 
tion (GC). 


Active References: 2 
Reachable Objects: 1 
Abandoned Objects: 1 


The first object that b referenced, Object 1, 
h f It’ hable. 
as no more references. It’s unreachable Book 


c = null; 


Assign the value nu11 to variable c. 
This makes c a null reference, meaning 
it doesn't refer to anything. But it’s still 
a reference variable, and another Book 
object can still be assigned to it. 


Object 2 still has an active 
reference (b), and as long 
as it does, the object is not 
eligible for GC. 


Active References: 1 
null References: 1 
Reachable Objects: 1 
Abandoned Objects: 1 
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primitives and references 


An array is like a tray of cups 


The Java standard library includes lots of sophisticated array element of that type. So in an array of type int (int[]), 
data structures including maps, trees, and sets (see each element can hold an int. In a Dog array (Dog|[]) each 
Appendix B), but arrays are great when you just want a element can hold...a Dog? No, remember that a reference 
quick, ordered, efficient list of things. Arrays give you fast variable just holds a reference (a remote control), not the 
random access by letting you use an index position to get object itself. So in a Dog array, each element can hold a 
to any element in the array. remote control to a Dog. Of course, we still have to make the 
Every element in an array is just a variable. In other Dog objects...and you'll see all that on the next page. 
words, one of the eight primitive variable types (think: Be sure to notice one key thing in the picture—the 
Large Furry Dog) or a reference variable. Anything you array is an object, even though it’s an array of 
would put in a variable of that type can be assigned to an primitives. 

Declare an int array variable. An array variable is Arrays are always objects, 

a remote control to an array object. 

WEN nU: whether they're declared to 


Create a new int array with a length al 
© of 7, and assign it to the previously Tererences. 


declared int [] variable nums 


nums = new int[7]; 


: ; Ti iabl 
5) Give each element in the array mi variables 


some int value. 
Remember, elements in an int 
array are just int variables. 


nums[0] = 6; int int int int int int 


nums[1] = 19; 


i 
i “ariables 


nums[2] = 44; 
i nums[3] = 42; 
nums [4] = 10; 


int array object (int[]) 


nums[5] = 20; 
Notice that the array itself is an object, 
even though the 7 elements are primitives. 


nums[6] = 1; 


Arrays are objects too 


You can have an array object that’s declared to hold primitive values. In other words, the 
array object can have elements that are primitives, but the array itself is never a primitive. 
Regardless of what the array holds, the array itself is always an object! 


YR 


hold primitives or object 


int 
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an array of objects 
Make an array of Dogs 


Declare a Dog array variable 
Dog[] pets; 


Create a new Dog array with 
a length of 7, and assign it to 
the previously declared Dog[] 
variable pets 


new Dog D 


What’s missing? 


Dogs! We have an array 
of Dog references, but no 
actual Dog objects! 


pets = 


Dog Dog Dog Dog Dog 


Dog array object (Dog[]) 


Dog[] 


Create new Dog objects, and 
assign them to the array o9 Obiecy 
elements. $ 

Remember, elements in a Dog 
array are just Dog reference 
variables. We still need Dogs! 


>% OPjecy 


pets[0] = new Dog(); 
pets[1] = new Dog(); 


—- Yours to solve. 


harpen our pencil 
erry 


What is the current value of 
pets[2]? 


Dog Dog 
What code would make 

pets[3] refer to one of the 
two existing Dog objects? 


Dog array object (Dog[]) 
Dog[] 
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bark() 
eat() 
chaseCat() 


Java cares about type- 


red an array; you 
u’ve decla nit except things 


tible array type- 


Once yo pata 
can’t put anything ! 
that are of a compa 
put a Cat into a Dog 


can't 
For example, you a awful if someone 


: ret 
array (it would be p are in the array, SO 


i + only Dogs i 
ae pee Me to bark, and a n T 
horror discover there's a cat lur na P 
you can't stick a double into ma a 
(spillage, remember?). You con, a le 
abyte into an int array, viel ae 

will always fit into an int -size va Lee 
known as an implicit widening. ae se 
the details later. for now just r wee 

that the compiler won't let w p iene 
wrong thing in an array, based on 


declared type. 


primitives and references 


Control your Dog 


(with a reference variable) 
Dog fido = new Dog(); 


fido.name = "Fido"; 


We created a Dog object and used 
the dot operator on the reference 
variable fido to access the name 
variable.* 


We can use the fido reference to 
get the dog to bark() or eat() or 
chaseCat(). 


fido .bark () ; 
fido.chaseCat () ; 


What happens if the Dog is in 
a Dog array? 


We know we can access the Dog’s instance 
variables and methods using the dot 
operator, but on what? 


When the Dog is in an array, we don’t have 
an actual variable name (like fido). Instead 
we use array notation and push the remote 
control button (dot operator) on an object 

at a particular index (position) in the array: 


Dog[] myDogs = new Dog[3]; 
myDogs[0] = new Dog(); 
myDogs[0].name = "Fido"; 


myDogs [0] .bark() ; 


*Yes we know we're not demonstrating encapsulation here, but we're 
trying to keep it simple. For now. We'll do encapsulation in Chapter 4. 
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using references 


class Dog { 
String name; 


A Dog example 


public static void main(String[] args) { Dog 
// make a Dog object and access it iaie 
Dog dogl = new Dog (); les 
cial TYPE 
dogl.bark (); Strings are a Sper! A bark() 
dogl.name = "Bart"; <“~—_—_ of object: You a £ the eat() 
d assign them a5 OY haseCat() 
an ; hou chaseCa 
// now make a Dog array were primitives en: 9 
ve referentes? 
Dog[] myDogs = new Dog[3]; they re 
// and put some dogs in it Output 
ee new ae 
myDogs[1] = new Dog(); % java Dog 
myDogs[2] = dogl; 
null says Ruff! 
// now access the Dogs using the array last dog’s name is Bart 
// references 
Fred says Ruff! 
myDogs[0].name = "Fred"; 
myDogs[1].name = "Marge"; Marge says Ruff! 
Bart says Ruff! 
// Hmmmm... what is myDogs[2] name? 
System.out.print ("last dog’s name is "); 
System.out.printin(myDogs[2].name) ; 
// now loop through the array BULLET POINT 
// and tell all dogs to bark U OINTS 
int x = 0; = Variables come in two flavors: primitive and 
while (x < myDogs.length) { reference. 
myDogs [x] .bark (); 3 variable length = Variables must always be declared with a name 
x= x + 1; owas hav ete number of and a type. 
; o ae i ; ; ; 
} that aves y the array: = A primitive variable value is the bits representing 
} elements " the value (5, ‘a’, true, 3.1416, etc.). 


{ 


System.out.println(name + " 


public void bark () 
says Ruff!"); 


public void eat() { 


public void chaseCat() { 
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A reference variable value is the bits 
representing a way to get to an object on the 
heap. 

A reference variable is like a remote control. 
Using the dot operator (.) on a reference 
variable is like pressing a button on the remote 
control to access a method or instance variable. 


A reference variable has a value of nu11 when 
it is not referencing any object. 


An array is always an object, even if the array 
is declared to hold primitives. There is no such 
thing as a primitive array, only an array that 
holds primitives. 


primitives and references 


BE the Compiler 


_ Each of the Java files on this page 
. Fepresents a complete source file. 
= Your job is to play compiler and 
\ determine whether each of these 
files will compile and run 
without exception. If 
they won't, how would 
you fix them? 


A B 
class Books { class Hobbits { 
String title; String name; 
String author; 
} public static void main(String[] args) { 
Hobbits[] h = new Hobbits [3]; 
class BooksTestDrive { int z = 0; 


public static void main(String[] args) { 


Books[] myBooks = new Books[3]; while (z < 4) { 
int x = 0; z=z+41; 
myBooks[0].title = "The Grapes of Java"; h[z] = new Hobbits(); 
myBooks[1].title = "The Java Gatsby"; h[z].name = "bilbo"; 
myBooks[2].title = "The Java Cookbook"; if (z ==1) { 
myBooks[0].author = "bob"; h[z].name = "frodo"; 
myBooks[1].author = "sue"; } 
myBooks[2].author = "ian"; if (z == 2) { 
h[z].name = "sam"; 
while (x < 3) { } 
System. out.print (myBooks [x].title); System.out.print(h[z].name + "is a"); 
System.out.print(" by "); System.out.println("good Hobbit name"); 
System.out.print1n (myBooks[x].author) ; } 
x=xt1; } 


——> Answers on page 68. 
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exercise: Code Magnets 


Code Magnets 


A working Java program is all scrambled up 
on the fridge. Can you reconstruct the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 


ref = index[yl; 


int ref; 


while (y < 4) 


System.out.printin(islands[ref]); 


index[0] 


index [1] 
index[2] 


String [] islands = new String[4]; 


System.out.print ("island = "); 


new int[4]; 


File Edit Window Help Sunscreen 


Q 


% java TestArrays 
island = Fiji 


class TestArrays { 


island = Cozumel , 

public stati i : ; 
island = Bermuda atic void main(String [] args) { 
island Azores 


64 chapter3 ————> Answers on page 68. 


primitives and references 


class Triangle { L use a separate 
vt 
double area; (Sometimes We an were trying to 
int height; test elass» betan 


l save space on the Page: 
Psl Puzzle int length; 


Your job is to take code snippets from 
the pool and place them into the 

blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 


public static void main(String[] args) { 


while ( e 
all the snippets. Your goal is to 
make a class that will compile and 
run and produce the output listed. —— ~ height = (x + 1) * 2; 
.length = x + 4; 


Output 


System.out.print ("triangle "+x + ", area"); 
File Edit Window Help Bermuda 


System.out.printlin(" = " + -area); 
Sjava Triangle 
area 4.0 } 
area 
area x = 27; 


area 


Triangle t5 = ta[2]; 
ta[2].area = 343; 


System.out.print("y = " + y); 
Bonus Question! System.out.println(", t5 area = " + t5.area); 


For extra bonus points, use snippets } 
from the pool to fill in the missing 
output (above). 


void setArea() { 


= (height * length) / 2; 


} Note: Each snippet 
= from the pool can be 
used more than once! 


4, t5 area = 18.0 


4, t5 area = 343.0 
area 


27, t5 area = 18.0 int x; z 
ta.area E ane aa: 
ee 27,t5 area = 343.0 W y; A x=X+ ta.x 
Int x =U; x=X+2; 
ta[x].area _ n r ta(x) 
ta[x] = setArea(); intx=1; X=X-1; tak]  x<4 


Triangle [] ta = new Triangle(4); tax=setArea(); int y =x; i 

Triangle ta = new [] Triangle[4]; talx].setArea(); jag. ‘t= HEY Tangles; 

Triangle [] ta = new Triangle[4]; 30.0 talx] = new Triangle(); 
& ta.x = new Triangle(); 
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puzzle: Heap o’ Trouble 


A Heap o' Trouble 


A short Java program is listed to the 
right. When “// do stuff” is reached, 
some objects and some reference vari- 
ables will have been created. Your task 
is to determine which of the reference 
variables refer to which objects. Not all 
the reference variables will be used, and 
some objects might be referred to more 
than once. Draw lines connecting the 
reference variables with their matching 
objects. 


Tip: Unless you're way smarter than we 
are, you probably need to draw dia- 
grams like the ones on page 57-60 of 
this chapter. Use a pencil so you can 
draw and then erase reference links (the 
arrows going from a reference remote 
control to an object). 


Match ea 
variable wi 
objects). 


You might not have i 


erence: 


use every ve 


————> Answers on page 69. 
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th vex erence 


fh matching 


class HeapQuiz { 
int id = 0; 


public static void main(String[] args) { 
int x = 0; 
HeapQuiz[] hq = new HeapQuiz[5]; 
while (x < 3) { 
hq[x] = new HeapQuiz(); 
hq[x].id = x; 
x Sx * 1} 
} 
hq[3] = hq[1]; 
hq[4] = hq[1]; 
hq[3] = null; 
hq[4] = hq[0]; 
hq[0] = hq[3]; 
hq[3] = hq[2]; 
hq[2] = hq[0]; 
// do stuff 


Reference Variables: HeapQuiz Objects: 


primitives and references 


The case of the pilfered references 


It was a dark and stormy night. Tawny strolled into the programmers’ bullpen like she owned 
the place. She knew that all the programmers would still be hard at work, and she wanted help. 
She needed a new method added to the pivotal class that was to be loaded into the client’s 
new top-secret Java-enabled cell phone. Heap space in the cell phone’s memory was tight, and 
everyone knew it. The normally raucous buzz in the bullpen fell to silence as Tawny eased her 
way to the white board. She sketched a quick overview of the new method’s functionality and 
slowly scanned the room. “Well folks, it’s crunch time,” she purred. “Whoever creates the most 
memory efficient version of this method is coming with me to the client’s launch party on Maui 


Q 9. 
Five-Minute tomorrow...to help me install the new software.” 


Myster y The next morning Tawny glided into the bullpen. “Ladies and Gentlemen,” she smiled, 
“the plane leaves in a few hours, show me what you’ ve got!” Bob went first; as he 
"Ue began to sketch his design on the white board, Tawny said, “Let’s get to the point Bob, 
show me how you handled updating the list of contact objects.” Bob quickly drew a 
A A code fragment on the board: 


Contact [] contacts = new Contact[10]; 


while (x < 10) { // make 10 contact objects 
contacts [x] = new Contact (); 
x = xX + 1l; 


} 
// do complicated Contact list updating with contacts 


“Tawny, I know we’re tight on memory, but your spec said that we had to be able to access 
individual contact information for all ten allowable contacts; this was the best scheme I could 
cook up,” said Bob. Kate was next, already imagining coconut cocktails at the party, “Bob,” 
she said, “your solution’s a bit kludgy, don’t you think?” Kate smirked, “Take a look at this 


baby”: 


Contact contactRef; 

while ( x < 10) { // make 10 contact objects 
contactRef = new Contact (); 
x = xX + 1l; 


} 
// do complicated Contact list updating with contactRef 


“I saved a bunch of reference variables worth of memory, Bob-o-rino, so put away your 
sunscreen,” mocked Kate. “Not so fast Kate!” said Tawny, “‘you’ve saved a little memory, but 
Bob’s coming with me.” 


Why did Tawny choose Bob’s method over Kate’s, when Kate’s used less memory? 


— r 
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exercise solutions 


| Solutions 


Sharpen your pencil (from page 52) 


l; int x = 34.55 K 7. s= y; X 

2. boolean boo = x;X 8. byte b = 

32 int g = Iry” 9. byte v = 

4. int y = gi y 10. short n 

5. y=y+ 10; 1l. ven; X 

6. short s; y 12. byte k = 128;X 


Code Magnets (from page 64) 


class TestArrays { 


public static void main(String[] args) 


int[] index = new int[4]; 
index[0] = 1; 
index[1] = 3; 
index[2] = 0; 


index[3] = 2; 
String[] islands = new String[4]; 
islands [0] 


"Bermuda"; 


islands[1] = "Fiji"; 
islands[2] = "Azores"; 
islands[3] = "Cozumel"; 
int y = 0; 

int ref; 


while (y < 4) { 
ref = index[y]; 
System.out.print ("island = "); 


System.out.printin (islands [ref] ) 


yoy + i; 


} File Edit Window Help Sunscreen 


% java TestArrays 
island = Fiji 


island = Cozumel 
island Bermuda 
island Azores 
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BE the Compiler (from page 63) 
class Books { 
String title; 
String author; 


class BooksTestDrive { 
public static void main(String[] args) { 


Books[] myBooks = new Books [3]; 


int x = 0; ber We have to 
myBooks[0] = new Books(); ae ae the Book 
myBooks[1] = new Books(); 2° aa He 
myBooks[2] = new Books(); a al 


myBooks[0].title = "The Grapes of Java"; 
myBooks[1].title = "The Java Gatsby"; 
myBooks[2].title = "The Java Cookbook"; 
myBooks[0].author = "bob"; 
myBooks[1].author = "sue"; 
myBooks[2].author = "ian"; 


while (x < 3) { 
System. out.print (myBooks[x].title); 
System.out.print(" by "); 
System. out.print1ln(myBooks[x].author) ; 
x= x + 1; 


class Hobbits { 
String name; 


public static void main(String[] args) { 
Hobbits[] h = new Hobbits [3]; 


mez Fl, emember: ar 
while (z < 2){ with rene i start 
z= 2+ 1; 
h[z] = new Hobbits (); 
h[z].name = "bilbo"; 
if (Zz == 1) 4 
h[{z].name = "frodo"; 
} 
if (z == 2) { 
h[z].name = "sam"; 


System.out.print(h[z].name + "is a"); 
System.out.println ("good Hobbit name"); 


ISR Puzzle Solutions 


Pos] Puzzle (from page 65) 


class Triangle { 
double area; 
int height; 
int length; 


public static void main(String[] args) { 
int x = 0; 
Triangle[] ta = new Triangle[4]; 
while (x<4) { 
ta[x] = new Triangle(); 
ta[x].height = (x + 1) * 2; 
ta[x]. length = x + 4; 
ta[x].setArea(); 
System.out.print ("triangle "+ x + 
", area"); 
System.out.printin(" = " + talx].area); 
x=x+1; 
} 
inty =x; 
x = 27; 
Triangle t5 = ta[2]; 
ta[2].area = 343; 
System.out.print("y = " + y); 
System.out.println(", t5 area = " + 
t5.area); 


} 


void setArea() { 
area = (height * length) / 2; 
} 
} 


%java Triangle 

triangle area 4.0 
triangle area 10.0 
triangle area = 18.0 


area = 28.0 


triangle 


y = 4, t5 area = 343.0 
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Five-Minute Mystery 
(from page 67) 


The case of the pilfered references 


Tawny could see that Kate’s method had a serious flaw. 
It’s true that she didn’t use as many reference variables 
as Bob, but there was no way to access any but the last 
of the Contact objects that her method created. With each 
trip through the loop, she was assigning a new object 
to the one reference variable, so the previously refer- 
enced object was abandoned on the heap—unreachable. 
Without access to nine of the ten objects created, Kate’s 
method was useless. 

(The software was a huge success, and the client gave Tawny and Bob an extra 


week in Hawaii. We'd like to tell you that by finishing this book you too will get stuff 
like that.) 


A Heap o' Trouble (from page 66) 


Reference Variables: 


HeapQuiz Objects: 
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4 methods use instance variables 


How Objects Behave 


Let's keep those little 
variables private, OK? 


State affects behavior, behavior affects state. We know that objects 

have state and behavior, represented by instance variables and methods. But until now, we 
haven't looked at how state and behavior are related. We already know that each instance of a 
class (each object of a particular type) can have its own unique values for its instance variables. 
Dog A can have a name “Fido” and a weight of 70 pounds. Dog B is “Killer” and weighs 9 pounds. 
And if the Dog class has a method makeNoise(), well, don’t you think a 70-pound dog barks a 
bit deeper than the little 9-pounder? (Assuming that annoying yippy sound can be considered 
a bark.) Fortunately, that’s the whole point of an object—it has behavior that acts on its state. In 
other words, methods use instance variable values. Like, “if dog is less than 14 pounds, make 


yippy sound, else...’ or “increase weight by 5.” Let’s go change some state. 
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objects have state and behavior 


Remember: a class describes what an 
object knows and what an object does 


A class is the blueprint for an object. When you 


write a class, you’re describing how the JVM should instance 
make an object of that type. You already know that variables 
every object of that type can have different instance (state) 
variable values. But what about the methods? h d setTitle() 
Can every object of that type have different E : ea 
: play() 
method behavior? 
Well...sort of.* 
Every instance of a particular class has the same os pscante 
we ' 


methods, but the methods can behave differently based 
on the value of the instance variables. 


The Song class has two instance variables, ttle and 
artist. When you call the play() method on an the 
instance, it will play the song represented by the 
value of the tale and artist instance variables for that 
instance. So, if you call the play() method on one 
instance, you'll hear the song “Havana” by Cabello, 
while another instance plays “Sing” by Travis. The 
method code, however, is the same. 


void play() { 


Cabello My Way 


Sinatra 


y Way 


ex Pistol 


soundPlayer.playSound(title, artist); 
} 
So 
ne stance Song ng 
Song songl = see gongt calling wt h ko ROY or s2.play(); 
song1.setArtist ("Travis"); N tavse ia) s1 .play (); 
Ni 


song1.setTitle ("Sing"); 


Song song2 new Song(); 
song2.setArtist ("Sex Pistols"); 


song2.setTitle ("My Way"); 


*Yes, another stunningly clear answer! 
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Calling play0) on this i 
will cause My Wi” bo a 


(but not the Sinatra one). 


The size affects the bark 


A small Dog’s bark is different from a big Dog’s bark. 


The Dog class has an instance variable size that the bark() 
method uses to decide what kind of bark sound to make. 


Dog 
class Dog { size 
i y name 
int size; 
String name; bark() 
void bark () { 


if (size > 60) { 
System.out.printlin("Wooof! Wooof!"); 
} else if (size > 14) { 
System.out.printlin("Ruff! Ruff!"); 
} else { 
System.out.printin("Yip! Yip!"); 


class DogTestDrive { 


public static void main(String[] args) { 
Dog one = new Dog(); 
one.size = 70; 
Dog two = new Dog(); 
two.size = 8; 
Dog three = new Dog(); 


three.size = 35; 


File Edit Window Help Playdead 


Sjava DogTestDrive 


one.bark (); 


two.bark(); 
three.bark(); Wooof! Wooof! 


} Yip! Yip! 
} Ruff! Ruff! 


methods use instance variables 


@ Bark Different. 
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method parameters 


You can send things to a method 


Just as you expect from any programming language, you can pass values into your 
methods. You might, for example, want to tell a Dog object how many times to 
bark by calling: 


d.bark (3); 


Depending on your programming background and personal preferences, you might 
use the term arguments or perhaps parameters for the values passed into a method. 
Although there are formal computer science distinctions that people who wear lab 
coats (and who will almost certainly not read this book) make, we have bigger fish 
to fry in this book. So you can call them whatever you like (arguments, donuts, hair- 
balls, etc.) but we’re doing it like this: 


A caller passes arguments. A method takes parameters. 


Arguments are the things you pass into the methods. An argument (a value like 
2, Foo, or a reference to a Dog) lands face-down into a...wait for it...parameter. 
And a parameter is nothing more than a local variable. A variable with a type and 
a name that can be used inside the body of the method. 


But here’s the important part: If a method takes a parameter, you must 
pass it something when you call it. And that something must be a value of 
the appropriate type. 
Dog d = new Dog(); 
Call the bark method on the Dog refer- . 
ence, and pass in the value 3 (as the d.bark (3) ; 
argument to the method). a argument 


value 3 are delivered into the 
bark method. 


O The bits representing the int 


o> 
a) 
Parameter The bits land in the numOfBarks 
int parameter (an int-sized variable). 


void bark (int numOfBarks) { 


while (numOfBarks > 0) { See ne NUMO Bante 


parameter as a variable in 


System.outsprintin ("rurt"); the method code. 


numOfBarks = numOfBarks - 1; 


} 
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methods use instance variables 


You can get things back from a method 


Methods can also return values. Every method is declared with a return 
type, but until now we’ve made all of our methods with a void return 
type, which means they don’t give anything back. 


void go() { 
} 


But we can declare a method to give a specific type of value back to 
the caller, such as: 


Cute... 

but not exactly what I 

was expecting. 

int giveSecret() { 
return 42; 

} 


If you declare a method to return a value, you must return 
a value of the declared type! (Or a value that is compatible 
with the declared type. We’ll get into that more when we 
talk about polymorphism in Chapters 7 and 8.) 


Whatever you say 
you'll give back, you 
better give back! 


The compiler won't let you return the wrong type of thing. 


int theSecret = life.giveSecret () ; 


These Bie s 


are returned 


i timg 4L a 
bite vT Set method, and lan 
n aa aS [a ine seca Ne | 
; in the variable name 
return 
this must fit 
} in an int, 
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multiple arguments 


You can send more than one thing 
to a method 


Methods can have multiple parameters. Separate them with 
commas when you declare them, and separate the argu- 
ments with commas when you pass them. Most importantly, 
if a method has parameters, you must pass arguments of the 
right type and order. 


Calling a two-parameter method and sending 
it two arguments 
void go() { 
TestStuff t = new TestStuff(); 
t.takeTwo(12, 34); 


The Arum 
} pe passed Chen 9 Pt ind ; 


irs Parameter First argument lands in the 


Selo 
Parameter, and so ii argument in the Setond 


void takeTwo(int x, int y) { 
int z = Xx + y; 


System. out .printiln ("Total is " + z); 


You can pass variables into a method, as long as 
the variable type matches the parameter type 


e 
void go() { G5 nd av A ks ™ + a 
int foo = 7; The valves kes So nor a (khe ane am 
à y yor m Yre bits 7) nd Ane 
int bar = 3; a Aata to “i hege. "wn aX 
yden £ khe w ih bits m 
t.takeTwo (foo, bar); Ee gentical ko 
are 
} \ 
void takeTwo(int x, int y) { 2 Its the same 
What’s the value oF =: aoe oo + bar 
int z = x + y; } et if You the 
result 1 3 öv. passed them in 
System.out .printlin("Total is " + z); ee sar ; 
e |wo 
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Java is pass-by-value. 


That means pass-by-copy. 


methods use instance variables 


Java is 
Pass 
by value 


Wash | 


tread Cat 
wait! = 
. Chick hy 
Make it A 


d 
Roses are red, 
poem is choppy: 


this 
passing by value 
ge is passing by COPY: 
g q Try it Replace our 
Declare an int variable oh, like you can d° = ae own. Better yet: 
int x = 7; 1) and assign it the value dumb seco ie hing with YOU own words 
int '7'. The bit pattern for replace the a forget it 
7 goes into the variable and youll n 
named x. 
ý 2) Declare a method with an int 
void go (int z){ } parameter named z. 
int 
ĉo 
Pea gS ® Call the go() method, passing 
9 ge the variable x as the argument. 
The bits in x are copied, and 
the copy lands in z. 
int int 
foo. go (x) ; void go(int z){ } 
x doesn’t change Sy and = aent R © Change the value of z inside 
iE sdas » tonnected wy the method. The value of x 
is doesn't change! The argument 
keen y passed to the z parameter was 
y int only a copy of x. 
void go(int 2) { The method can't change the 
z= 0; bits that were in the calling 
i variable x. 
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arguments and return values 


thereareno 
Dumb Questions 


: What happens if the argument you want to 
pass is an object instead of a primitive? 


A: You'll learn more about this in later chapters, 
but you already know the answer. Java passes 
everything by value. Everything. But...value means 
bits inside the variable. And remember, you don't 
stuff objects into variables; the variable is a remote 
control—a reference to an object. So if you pass a 
reference to an object into a method, you're passing 
a copy of the remote control. Stay tuned, though, 
we'll have lots more to say about this. 


Q: Can a method declare multiple return 
values? Or is there some way to return more than 
one value? 


A: Sort of. A method can declare only one return 
value. BUT...if you want to return, say, three int 
values, then the declared return type can be an int 
array. Stuff those ints into the array, and pass it on 
back. It’s a little more involved to return multiple 
values with different types; we'll be talking about 
that in a later chapter when we talk about ArrayList. 


Q: Do I have to return the exact type I declared? 


A: You can return anything that can be implicitly 
promoted to that type. So, you can pass a byte where 
an int is expected. The caller won't care, because the 
byte fits just fine into the int the caller will use for 
assigning the result. You must use an explicit cast 
when the declared type is smaller than what you're 
trying to return (we'll see these in Chapter 5). 


Q: Do I have to do something with the return 
value of a method? Can | just ignore it? 


A: Java doesn’t require you to acknowledge a 
return value. You might want to call a method with 
a non-void return type, even though you don't care 
about the return value. In this case, you're calling 
the method for the work it does inside the method, 
rather than for what the method gives returns. In 


Java, you don't have to assign or use the return value. 
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“Reminder: Java 
cares about type! 


You can’t return a Giraffe when 
the return type is declared 

as a Rabbit. Same thing with 
parameters. You can’t pass a 

zœ _ Giraffe into a method that takes 


4 K 
AA a Rabbit. 


Variable po 
& 


-—— BULLET POINTS 


= Classes define what an object knows and what an 
object does. 


= Things an object knows are its instance variables 
(state). 


= Things an object does are its methods (behavior). 


= Methods can use instance variables so that objects 
of the same type can behave differently. 


= A method can have parameters, which means you 
can pass one or more values in to the method. 


= The number and type of values you pass in must 
match the order and type of the parameters 
declared by the method. 


= Values passed in and out of methods can be 
implicitly promoted to a larger type or explicitly cast 
to a smaller type. 


= The value you pass as an argument to a method 
can be a literal value (2, ‘c’, etc.) or a variable of 
the declared parameter type (for example, x where 
x is an int variable). (There are other things you 
can pass as arguments, but we're not there yet.) 


= A method must declare a return type. A void return 
type means the method doesn’t return anything. 


= |famethod declares a non-void return type, it must 
return a value compatible with the declared return 


type. 


Cool things you can do with parameters 


and return types 


Now that we’ve seen how parameters and return types work, it’s time 
to put them to good use: let’s create Getters and Setters. If you’re 
into being all formal about it, you might prefer to call them Accessors 
and Mutators. But that’s a waste of perfectly good syllables. Besides, 
Getters and Setters fits a common Java naming convention, so that’s 
what we'll call them. 


Getters and Setters let you, well, get and set things. Instance variable val- 
ues, usually, A Getter’s sole purpose in life is to send back, as a return 
value, the value of whatever it is that particular Getter is supposed to 
be Getting, And by now, it’s probably no surprise that a Setter lives and 
breathes for the chance to take an argument value and use it to set the 
value of an instance variable. 


class ElectricGuitar { 
String brand; 
int numOfPickups; 
boolean rockStarUsesIt; 


String getBrand() { 
return brand; 


} 


void setBrand(String aBrand) { 
brand = aBrand; 
} 


int getNumOfPickups() { 
return numOfPickups; 


} 


void setNumOfPickups(int num) { 
numOfPickups = num; 


} 


boolean getRockStarUsesIt() { 
return rockStarUsesIt; 


} 


void setRockStarUsesIt (boolean yesOrNo) { 
rockStarUsesIt = yesOrNo; 


} 


methods use instance variables 


ElectricGuitar 


brand 
numOfPickups 
rockStarUseslt 
Note: Using, 
hese namin), 
getBrand() se ventions means 
} Nowin 
ae Ta adar that 
getNumOfPickups() ovll see ne 
€ 
setNumOfPickups() of Java to 
getRockStarUseslt() 


setRockStarUseslt() 
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real developers encapsulate 


Encapsulation 


Do it or risk humiliation and 
ridicule. 


Until this most important moment, we’ve 
been committing one of the worst OO faux 
pas (and we’re not talking minor violation 
like showing up without the “B” in BYOB). 
No, we’re talking Faux Pas with a capital 


“E 33 And “P 33 
Our shameful transgression? 
Exposing our data! 


Here we are, just humming along without a 
care in the world leaving our data out there 
for anyone to see and even touch. 


You may have already experienced that 
vaguely unsettling feeling that comes with 
leaving your instance variables exposed. 


Exposed means reachable with the dot opera- 
tor, as in: 


theCat .height = 27; 


Think about this idea of using our remote 
control to make a direct change to the Cat 
object’s size instance variable. In the hands of 
the wrong person, a reference variable (remote 
control) is quite a dangerous weapon. Because 
what’s to prevent: 


EK On wy. 2008 oven 
theCat. height = 0; et \et this pye 


This would be a Bad Thing. We need to build 
setter methods for all the instance variables, 
and find a way to force other code to call the 
setters rather than access the data directly. 
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Jen says you're 
well-encapsulated... 


body 


i to call a setter 
ares ing erar protect the cat trom 
me ) 


unaceeptable size changes: 


public void setHeight (int ht) { 


if (ht > 9) { < 
We put in 
é 


height = ht; Juarantee 4 À 
In = 
} mum cat height. 


heeks to 


Hide the data 


Yes, it ¿s that simple to go from 
an implementation that’s just 
begging for bad data to one that 
protects your data and protects 
your right to modify your 
implementation later. 


OK, so how exactly do you Aide 
the data? With the public 
and private access modifiers. 
Yow re familiar with public— 
we use it with every main 
method. 


Here’s an encapsulation starter 
rule of thumb (all standard 
disclaimers about rules of 
thumb are in effect): mark your 
instance variables private and 
provide public getters and 
setters for access control. When 
you have more design and cod- 
ing savvy in Java, you will prob- 
ably do things a little differently, 
but for now, this approach will 
keep you safe. 


Mark instance 
variables private. 


Mark getters and 
setters public. 


“Sadly, Bill forgot to 
encapsulate his Cat class and 
ended up with a flat cat.” 


(overheard at the water cooler) 
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Java Exposed 


This week’s interview: 
An Object gets candid about encapsulation. 


HeadFirst: What’s the big deal about encapsulation? 


Object: OK, you know that dream where you're giving a talk to 500 people when you 
suddenly realize you’re naked? 


HeadFirst: Yeah, we've had that one. It’s right up there with the one about the Pilates 
machine and...no, we won't go there. OK, so you feel naked. But other than being a little 
exposed, is there any danger? 


Object: Is there any danger? Is there any danger? [starts laughing] Hey, did all you other 
instances hear that, “Ls there any danger?” he asks? [falls on the floor laughing] 


HeadFirst: What’s funny about that? Seems like a reasonable question. 

Object: OK, TIl explain it. It’s [bursts out laughing again, uncontrollably] 
HeadFirst: Can I get you anything? Water? 

Object: Whew! Oh boy, No I’m fine, really. PI be serious. Deep breath. OK, go on. 
HeadFirst: So what does encapsulation protect you from? 


Object: Encapsulation puts a force-field around my instance variables, so nobody can set 
them to, let’s say, something znappropriate. 


HeadFirst: Can you give me an example? 


Object: Happy to. Most instance variable values are coded with certain assumptions 
about their boundaries. Like, think of all the things that would break if negative numbers 
were allowed. Number of bathrooms in an office. Velocity of an airplane. Birthdays. 
Barbell weight. Phone numbers. Microwave oven power. 


HeadFirst: I see what you mean. So how does encapsulation let you set boundaries? 


Object: By forcing other code to go through setter methods. That way, the setter method 
can validate the parameter and decide if it’s doable. Maybe the method will reject it and 
do nothing, or maybe it'll throw an Exception (like if it’s a null Social Security number 
for a credit card application), or maybe the method will round the parameter sent in to 
the nearest acceptable value. The point is, you can do whatever you want in the setter 
method, whereas you can’t do anything if your instance variables are public. 


HeadFirst: But sometimes I see setter methods that simply set the value without check- 
ing anything. If you have an instance variable that doesn’t have a boundary, doesn’t that 
setter method create unnecessary overhead? A performance hit? 


Object: The point to setters (and getters, too) is that you can change your mind later, 
without breaking anybody else’s code! Imagine if half the people in your com- 

pany used your class with public instance variables, and one day you suddenly realized, 
“Oops—there’s something I didn’t plan for with that value, I’m going to have to switch 

to a setter method.” You break everyone’s code. The cool thing about encapsulation is 
that you get to change your mind. And nobody gets hurt. ‘The performance gain from using 
variables directly is so miniscule and would rarely—if ever—be worth it. 
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how objects behave 


Encapsulating the 
GoodDog class 


ye WN ake: 
Mele ee 


pe getter 
peh methods Qe 


: i 
Lhouah the methods don t veally 
Pren a ekionality the nice thing 


ind later. 
is that you can Change your min 
Vo AA back and make a method 


safer, faster, better: 


Any place where a 
particular value can 
be used, a method 
call that returns that 
type can be used. 


instead of: 
int x = 3 + 24; 


you can say: 


int x = 3 + one.getSize(); 
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wstanie 


class GoodDog { 


private int size; 


public int getSize() { 
return size; 


} 


and 
bit > public void setSize (int s) { 


size = s; 


void bark() { 
if (size > 60) { 


GoodDog 


size 


getSize( ) 


setSize( ) 
bark( ) 


System.out.printlin("Wooof! Wooof!"); 
} else if (size > 14) { 

System.out.printin("Ruff! Ruff!"); 
} else { 

System.out.printlin("Yip! Yip!"); 


class GoodDogTestDrive { 


public static void main(String[] args) { 


GoodDog one = new GoodDog(); 
one.setSize(70); 

GoodDog two = new GoodDog(); 
two.setSize (8); 
System.out.println("Dog one: 
System.out.println("Dog two: 
one.bark (); 


two.bark (); 


" + one.getSize()); 
" + two.getSize()); 
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How do objects in an array 
behave? 


Just like any other object. The only difference is how you 
get to them. In other words, how you get the remote con- 
trol. Let’s try calling methods on Dog objects in an array. 


Declare and create a Dog array 
to hold seven Dog references. 


Dog[] pets; 


pets = new eed 


Create two new Dog objects, 
and assign them to the first 
two array elements. 
pets[0] = new Dog(); 
pets[1] = new Dog(); 


Q Call methods on the two Dog 
objects. 
pets[0].setSize (30); 
int x = pets[0].getSize(); 
pets[1].setSize (8); 


Dog array object (Dog[]) 
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initializing instance variables 


Declaring and initializing 
instance variables 


You already know that a variable declaration needs at least a name and 
a type: 

int size; 

String name; 


And you know that you can initialize (assign a value to) the variable at 
the same time: 


int size = 420; 
String name = "Donny"; 


But when you don’t initialize an instance variable, what happens when 

you call a getter method? In other words, what is the value of an instance 
variable before you initialize it? 

stance variables, 


clave two | 
class PoorDog { De a value 


1 assign 
but don t 
private int size; Z u 
private String name; 
i e return?? 
public int getSize() { 4 What will thes 
return size; 


} 


public String getName () { 
return name; 


} 


public class PoorDogTestDrive { 
public static void main(String[] args) { 
PoorDog one = new PoorDog() ; 


Instance variables 
always get a 
default value. If 
you don’t explicitly 
assign a value 

to an instance 
variable or you 
don’t call a setter 


method, the 
instance variable 
still has a value! 


integers 0 
floating points 0.0 
booleans false 


references null 


nik wi 


What 4° Peile 


gris Oen 


System. out .printiln ("Dog size is " + one.getSize()); 
System. out .printiln ("Dog name is " + one.getName()); 


} 


You don 


File Edit Window Help CallVet 


Q 


% java PoorDogTestDrive 


Dog size is 0 


Dog name is null 
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t have to wnitialize instant 
\ways have â 
uding char 
ject referent 


because they 3 
vimitives (i 
alse, and o 


(Remember, null just means 


isnt è trolling / progr 
A renit, but no actua 


e variables, 
Number 


default value. 
) get O, booleans get 

e variables get null. 

a remote control that 
ammed to anything; A 

\ object) 


The difference between instance 
and local variables 


Instance variables are declared 
inside a class but not within a method. 


class Horse { 
private double height = 15.2; 
private String breed; 
// more code... 


2) Local variables are declared within a method. 


class AddThing { 
int a; y 
int b = 12; 


public int add() { 
int total = a + b; 


INSTANCE variables 


<— LOCAL variable 


return total; 


} 


Local variables MUST be initialized before use! 
ee aM 


class Foo { 


Won't compilel! You can 


public void go() { 
declare * without a value, 


int x; 


tey 
} as you 
Da ae wet AEE the compiler 
} — freaks out- 


| File Edit Window Help Yikes 
% javac Foo. java 


Foo.java:4: 


variable x might 
not have been initialized 


int z = x + 3; 
1 error A 
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Local variables do 
NOT get a default 
value! The compiler 
complains if you 
try to use a local 
variable before 

the variable is 
initialized. 


there, are_no 


Dumb Questions 


Q; What about method parameters? 
How do the rules about local variables 
apply to them? 


A: Method parameters are virtually the 
same as local variables—they’re declared 
inside the method (well, technically they’re 
declared in the argument list of the method 
rather than within the body of the method, 
but they’re still local variables as opposed to 
instance variables). But method parameters 
will never be uninitialized, so you'll never get 
a compiler error telling you that a parameter 
variable might not have been initialized. 


Instead, the compiler will give you an error 
if you try to invoke a method without giving 
the arguments that the method needs. So 
parameters are always initialized, because 
the compiler guarantees that methods are 
always called with arguments that match 
the parameters. The arguments are assigned 
(automatically) to the parameters. 
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object equality 


Comparing variables (primitives or references) 


Sometimes you want to know if two primitives are the same; for example, 


you might want to check an int result with some expected integer value. Use aa to comp are two 
That’s easy enough: just use the == operator. Sometimes you want to know Primitives or to see £ 


if two reference variables refer to a single object on the heap; for example, 

is this Dog object exactly the same Dog object I started with? Easy as well: two references refer to 
just use the == operator. But sometimes you want to know if two objects are p 

equal. And for that, you need the .equals() method. the same object. 


The idea of equality for objects depends on the type of object. For Use the equals() method 
example, if two different String objects have the same characters (say, “my to See £ two different 


name”), they are meaningfully equivalent, regardless of whether they are i 

two distinct objects on the heap. But what about a Dog? Do you want to objects are equal. 

treat two Dogs as being equal if they happen to have the same size and 

weight? Probably not. So whether two different objects should be treated (Eg, two different String objects that 
as equal depends on what makes sense for that particular object type. We’ll both contain the characters “Fred”) 
explore the notion of object equality again in later chapters, but for now, 

we need to understand that the == operator is used only to compare the bits in two variables. 

What those bits represent doesn’t matter. The bits are either the same, or they’re not. 


To compare two primitives, use the == operator 
—— 


me == operator can be used to compare two variables of any kind, and it simply compares ie " Patterns Se 
¢, 

the bits. are equal u ese two 
if (a == b) {...} looks at the bits in a and b and returns true if the bit pattern is the same 
(although all the extra zeros on the left end don’t matter). e zeros 0n 

. eare ™ wh 

ee “Whe left side of pe 

byte b = 3; but we don t t“ 

hat ere) 
if (a == b) { // true } 


To see if two references are the same (which means they refer to 
the same object on the heap) use the == operator The bj 


Remember, the == operator cares only about the pattern of bits in the variable. The rules 
are the same whether the variable is a reference or primitive. So the == operator returns 
true if two reference variables refer to the same object! In that case, we don’t know what the 
bit pattern is (because it’s dependent on the JVM and hidden from us), but we do know that 


whatever it looks like, it will be the same for two references to a single object. nl 


Sing == 


Foo a =new Foo(); 


Foo b = new Foo(); 


e- 
ont 
di =p 
g 


tab 


Foo c = a; 


Foo 
if (a == b) { } // false a == ¢ is true 
if (a == c) { } // true a == bis false Foo 
if (b == c) { } // false 
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I always 
keep my variables 
private. If you want to 
see them, you have to 
talk to my methods. 


G harpen our pencil 
ae? 


What’s legal? 


Given the method below, which of 
the method calls listed on the right 
are legal? 


KEEP 


= 
RIGHT 


Put a checkmark next to the ones 
that are legal. (Some statements are 
there to assign values used in the 
method calls.) 


int calcArea(int height, int width) { 


return height * width; 


> Answers on page 93. 
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BULLET POINTS 


Encapsulation gives you control over who changes the 
data in your class and how. 


Make an instance variable private so it can’t be changed 
by accessing the variable directly. 


Create a public mutator method, e.g., a setter, to control 
how other code interacts with your data. For example, 
you can add validation code inside a setter to make sure 
the value isn’t changed to something invalid. 


Instance variables are assigned values by default, even 
if you don’t set them explicitly. 


Local variables, e.g., variables inside methods, are 
not assigned a value by default. You always need to 
initialize them. 


Use == to check if two primitives are the same value. 


Use == to check if two references are the same, i.e., two 
object variables are actually the same object. 


Use .equals() to see if two objects are equivalent (but 
not necessarily the same object), e.g., to check if two 
String values contain the same characters. 


int a = calcArea(7, 12); 
short c = 7; 
calcArea(c, 15); 


int d = calcArea(57); 
calcArea(2, 3); 


long t = 42; 
int £ = calcArea(t, 17); 


int g = calcArea(); 


calcArea (); 


byte h = calcArea(4, 20); 


int j = calcArea(2, 3, 5); 
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exercise: Be the Compiler 


BE the Compiler 


Each of the Java files on this page 

. Fepresents a complete source file. 

= Your job is to play compiler and 

A, determine whether each of these files 
will compile. If they won't 
compile, how would you 
fix them, and if they do 
compile, what would be 
their output? 


class XCopy { class Clock { 
String time; 
public static void main(String[] args) { 


int orig = 42; void setTime(String t) { 
XCopy x = new XCopy(); time = t; 
int y = x.go(orig); } 
System.out.println(orig + " "+ y); 

} void getTime() { 

return time; 

int go(int arg) { } 
arg = arg * 2; } 
return arg; 

} class ClockTestDrive { 

} public static void main(String[] args) { 


Clock c = new Clock(); 
c.setTime ("1245"); 
String tod = c.getTime(); 
System.out.println("time: "+tod); 
————— Answers on page 93. 
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methods use instance variables 


A bunch of Java components, in full costume, are playing a party 
game, “Who am |?” They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be 
true for more than one attendee, then write down all for whom that 
sentence applies. Fill in the blanks next to the sentence with the 
names of one or more attendees. 


9 Tonight’s attendees: 
mi Py instance variable, argument, return, getter, setter, 
A encapsulation, public, private, pass by value, method 


A class can have any number of these. 
A method can have only one of these. 
This can be implicitly promoted. 

| prefer my instance variables private. 
It really means “make a copy.” 

Only setters should update these. 

A method can have many of these. 

| return something by definition. 

| shouldn’t be used with instance variables. 
I can have many arguments. 

By definition, | take one argument. 
These help create encapsulation. 


| always fly solo. 


——— Answers on page 93. 
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puzzle: Mixed Messages 


Messages 


A short Java program is listed to your right. 
Two blocks of the program are missing. 
Your challenge is to match the candidate 
blocks of code (below) with the output 
that you'd see if the blocks were inserted. 


Not all the lines of output will be used, and 
some of the lines of output might be used 
more than once. Draw lines connecting 
the candidate blocks of code with their 
matching command-line output. 


Candidates: 


i < 9 14 7 
index < 5 95 
i < 20 iL il 
index < 5 14 1 
i < 7 ZB) Al 
index < 7 7 
i, < 19 20 1 
index < 1 A0) & 
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Possible output: 


public class Mix4 { 


int counter = 0; 


public static void main(String[] args) { 

int count = 0; 

Mix4[] mixes = new Mix4[20]; 

int i = 0; 

while ([ J) ¢ 
mixes[i] = new Mix4(); 
mixes[i].counter = mixes[i].counter + 1; 
count = count + 1; 
count = count + mixes[i].maybeNew (i); 
i = i + 1; 

} 

System.out.println(count +" "+ 


mixes[1].counter) ; 


public int maybeNew(int index) { 
Mix4 mix = new Mix4(); 
mix.counter = mix.counter + 1; 
return 1; 
} 


return 0; 


————> Answers on page 94. 


methods use instance variables 


public class Puzzle4 { 


public static void main(String [] args) { 


int number = 1; 
Pos] Puzzle int i = 0; 
while (i < 6) { 
\ Your job is to take code snippets from the 
LE pool and place them into the blank lines 
Gy in the code. You may not use the same 
snippet more than once, and you won't 
need to use all the snippets. Your goal 
is to make a class that will compile and } 
run and produce the output listed. 


number = number * 10; 


int result = 0; 
i = 6; 
Answers on page 94. while (i > 0) { 


result = result + 


} 


Output System.out.println ("result " + result); 
} 
%java Puzzle4 } 
result 543345 
class sA 
int intValue; 
doStuff (int ) { 
if (intValue > 100) { 
return 
} else { 
return 


Note: Each snippet 
from the pool can be 
used only once! 


values.doStuff(i); 
values[i].doStuff(factor); 


intValue=i; — yalues[i].doStuff(i); 
values.intValue = i; intValue T factor; Puzzle4 `“ r 
E ‘ i . n 
values[i].intValue = i; maine intValue * (2 + factor); i 


values[i].intValue = number intValue * (5 - factor); 


* factor 4 tValue * factor: Value() Ma 
uzzle4 [ ] values = new Puzzle4[6]; public intvatue “Tactor values [i] = new Value(i); 
Value [] values = new Value[6]; exivate i=i+1; values [] = new Value( ); 


Value [ ] values = new Puzzle4[6]; i=i-1; values [i] = new Value( ); 


values = new Value( ); 
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puzzle: Five Minute Mystery 


92 


chapter 4 


Fast Times in Stim-City 


When Buchanan roughly grabbed Jai’s arm from behind, Jai froze. Jai knew that Buchanan was 
as stupid as he was ugly and he didn’t want to spook the big guy. Buchanan ordered Jai into his 
boss’s office, but Jai’d done nothing wrong (lately), so he figured a little chat with Buchanan’s 
boss Leveler couldn’t be too bad. He’d been moving lots of neural-stimmers in the west side 
lately, and he figured Leveler would be pleased. Black market stimmers weren’t the best money 
pump around, but they were pretty harmless. Most of the stim-junkies he’d seen tapped out after 
a while and got back to life, maybe just a little less focused than before. 


Leveler’s “office” was a skungy-looking skimmer, but once Buchanan shoved him in, Jai could 
see that it’d been modified to provide all the extra speed and armor that a local boss like Leveler 
could hope for. “Jai my boy,” hissed Leveler, “pleasure to see you again.” “Likewise I’m sure...,” 
said Jai, sensing the malice behind Leveler’s greeting, “We should be square Leveler, have I 
missed something?” “Ha! You’re making it look pretty good, Jai. Your volume is up, but I’ve 
been experiencing, shall we say, a little ‘breach’ lately,” said Leveler. 


Jai winced involuntarily; he’d been a top drawer jack-hacker in his day. Anytime someone fig- 
ured out how to break a street-jack’s security, unwanted attention turned toward Jai. “No way it’s 
me man,” said Jai, “not worth the downside. I’m retired from hacking, I just move my stuff and 

mind my own business.” “Yeah, yeah,” laughed Leveler, “I’m sure you’re clean on this 
one, but Ill be losing big margins until this new jack-hacker is shut out!” “Well, best 
of luck, Leveler. Maybe you could just drop me here and I'll go move a few more 

‘units’ for you before I wrap up today,” said Jai. 


“T m afraid it’s not that easy, Jai. Buchanan here tells me that word is you’ re cur- 
rent on Java NE 37.3.2,” insinuated Leveler. “Neural edition? Sure, I play around a 
bit, so what?” Jai responded, feeling a little queasy. “Neural edition’s how I let the stim- 
junkies know where the next drop will be,” explained Leveler. “Trouble is, some stim-junkie’s 
stayed straight long enough to figure out how to hack into my Warehousing database.” “I need a 
quick thinker like yourself, Jai, to take a look at my StimDrop Java NE class; methods, instance 
variables, the whole enchilada, and figure out how they’re getting in. It should...,” “HEY!” 
exclaimed Buchanan, “I don’t want no scum hacker like Jai nosin’ around my code!” “Easy big 
guy,” Jai saw his chance, “I’m sure you did a top rate job with your access modi...” “Don’t tell 
me, bit twiddler!” shouted Buchanan, “I left all of those junkie-level methods public so they 
could access the drop site data, but I marked all the critical WareHousing methods private. No- 
body on the outside can access those methods, buddy, nobody!” 


“I think I can spot your leak, Leveler. What say we drop Buchanan here off at the corner and 
take a cruise around the block?” suggested Jai. Buchanan clenched his fists and started toward 
Jai, but Leveler’s stunner was already on Buchanan’s neck, “Let it go, Buchanan,” sneered Lev- 
eler, “Keep your hands where I can see them and step outside. I think Jai and I have some plans 


to make.” 
What did Jai suspect? 


Will he get out of Leveler’s skimmer with all his bones intact? 


————> Answers on page 94. 


Exercise Sotutions 


Sharpen your pencil (from page 87) 


int a = calcArea(7, 
short c = 7; 
calcArea(c, 


12); 


Va 


calcArea (57); 


calcArea(2, 3); -a 


15)7 


int d = 


long t = 42; 
int f = calcArea (t, 17); 
int g = calcArea(); 


calcArea(); 


byte h = calcArea(4, 20); 


int j = calcArea (2, 3, 5); 


A class can have any number of these. 
A method can have only one of these. 
This can be implicitly promoted. 

| prefer my instance variables private. 
It really means “make a copy.” 

Only setters should update these. 

A method can have many of these. 


| return something by definition. 


BE the Compiler (from page 88) 


| shouldn’t be used with instance variables 


I can have many arguments. 


Who Am I 2 (from page 89) 


By definition, | take one argument. 
These help create encapsulation. 


| always fly solo. 


methods use instance variables 


Class ‘XCopy’ compiles and runs as it stands! The 
output is: ‘42 84’. Remember, Java is pass by value, 
(which means pass by copy), and the variable ‘orig’ is 
not changed by the go( ) method. 


class Clock { 
String time; 


void setTime(String t) { 
time = t; 


} 


String getTime() { 
return time; 
Note: ‘Getter 
vetun LYRE by 


methods have à 
definition. 


class ClockTestDrive { 
public static void main(String[] args) { 
Clock c = new Clock(); 
c.setTime ("1245"); 
String tod = c.getTime(); 
System.out.println("time: " + tod); 
} 


instance variables, getter, setter, method 


return 


return, 


argument 


encapsulation 


pass by value 


instance variables 


argument 


getter 
public 
method 
setter 
getter, 


return 


setter, public, private 
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puzzle solutions 


Puzzle Solutions 
Five-Minute Mystery (from page 92) 


What did Jai suspect? 


Poo] Puzzle (from page 91) 


public class Puzzle4 { 
public static void main(String[] args) { 


Value[] values = new Value[6]; Jai knew that Buchanan wasn’t the sharpest 

Tor SSE al pencil in the box. When Jai heard Buchanan 

e a P talk about his code, Buchanan never mentioned 
values{i] = new Value(); his instance variables. Jai suspected that while 
values[i].intValue = number; Buchanan did in fact handle his methods 
number = number * 10; correctly, he failed to mark his instance variables 
i=i+1; 


private. That slip-up could have easily cost 


} Leveler thousands. 


int result = 0; 
i = 6; 
while (i > 0) { 
i=i-1; 
result = result + values[i].doStuff(i); 


} Mixed 
System.out.printlin("result " + result); Messages (from page 90) 
} 
} 
Candidates: Possible output: 


class Value { 
int intValue; i << 9 1a y 


publicint doStuff (int factor) { index < 5 


if (intValue > 100) { 2 5 
return intValue* factor; 
} else { F 
return intValue * (5 - factor); i <20 19 d 
} 
} index < 5 14 1 
} 
Output 5 
i 1 
aed i 
%java Puzzle4 
5J index < 7 g7. 


result 543345 


i < 19 o 


index < 1 20m5 


94 chapter 4 


5 writing a program 


Extra-Strength Methods 


T can lift 
heavy objects. 


Let’s put some muscle in our methods. we dabbled with variables, played 
with a few objects, and wrote a little code. But we were weak. We need more tools. Like 
operators. We need more operators so we can do something a little more interesting than, 
say, bark. And loops. We need loops, but what's with the wimpy while loops? We need for 
loops if we're really serious. Might be useful to generate random numbers. Better learn 
that too. And why don't we learn it all by building something real, to see what it’s like to write 
(and test) a program from scratch. Maybe a game, like Battleships. That’s a heavy-lifting task, 
so it'll take two chapters to finish. We'll build a simple version in this chapter and then build a 


more powerful deluxe version in Chapter 6, Using the Java Library. 


this is a new chapter 95 


building a real game 


Let’s build a Battleship-style 
game: “Sink a Startup” 


It’s you against the computer, but unlike the real Battleship 
game, in this one you don’t place any ships of your own. 
Instead, your job is to sink the computer’s ships in the fewest 
number of guesses. 


Oh, and we aren’t sinking ships. We’re killing ill-advised, 
Silicon Valley Startups (thus establishing business relevancy 
so you can expense the cost of this book). 


Goal: Sink all of the computer’s Startups in the fewest 
number of guesses. You’re given a rating or level, based on 
how well you perform. 


Setup: When the game program is launched, the computer 
places three Startups on a virtual 7 x 7 grid. When that’s 
complete, the game asks for your first guess. 


How you play: We haven't learned to build a GUI yet, 

so this version works at the command line. The computer 
will prompt you to enter a guess (a cell) that you'll type at 
the command line as “A3,” “C5,” etc.). In response to your 
guess, you'll see a result at the command-line, either “hit,” 
“miss,” or “You sunk poniez” (or whatever the lucky Startup 
of the day is). When you’ve sent all three Startups to that big 
404 in the sky, the game ends by printing out your rating, 


T starts at zero, like Java arrays 
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You’re going to build the 
Sink a Startup game, with 
a 7 x7 grid and three 
Startups. Each Startup 
takes up three cells. 


part of a game interaction 


File Edit Window Help Sell 


%java StartupBust 
Enter a guess A3 
miss 

Enter 

miss 

Enter 

miss 

Enter 

hit 

Enter 

hit 

Enter a guess D4 
Ouch! You sunk poniez 
kill 

Enter G3 

hit 

Enter 

hit 

Enter a guess G5 
Ouch! You sunk hacqi R 


All Startups are dead! Your stock 
is now worthless 


Took you long enough. 62 guesses. 


First, a high-level design 


We know we'll need classes and methods, but what 
should they be? To answer that, we need more infor- 
mation about what the game should do. 


First, we need to figure out the general flow of the 
game. Here’s the basic idea: 


1) User starts the game. 


A) Game creates three Startups 


Game places the three Start- 
ups onto a virtual grid 


Game play begins. 


Repeat the following until there are 
no more Startups: 


Prompt user for a guess 
CA2" "CO," etc.) 


Check the user guess against 
all Startups to look for a hit, 
miss, or kill. Take appropri- 
ate action: if a hit, delete cell 
(A2, D4, etc.). If a kill, delete 
Startup. 


Game finishes. 


Give the user a rating based on 
the number of guesses. 


Now we have an idea of the kinds of things the 
program needs to do. The next step is figuring out 
what kind of objects we'll need to do the work. 
Remember, think like Brad rather than Laura (who 
we met in Chapter 2, A Trip to Objectville); focus 

first on the things in the program rather than the 
procedures. 


writing a program 


wele means 
A ew Ciieh 


start or 


\e is 
A vetia erect 


ra an attion 


Game setup Q fB) 


Get user 


guess (a) 
A remove 
guess location cell 


A diamond 


kill represents a 
remove detision point. 
Startup 


still some 
Startups 
alive? 


no 
display user 
score/rating 


Whoa. A real flow chart. 
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a simpler version of the game 


The “Simple Startup Game” 
a gentler introduction 


It looks like we’re gonna need at least two classes, a Game 
class and a Startup class. But before we build the full- 
monty Sink a Startup game, we'll start with a stripped- 
down, simplified version, Simple Startup Game. We'll 
build the simple version in tis chapter, followed by the 
deluxe version that we build in the next chapter. 


Everything is simpler in this game. Instead of a 2-D grid, 
we hide the Startup in just a single row. And instead of three 
Startups, we use one. 


The goal is the same, though, so the game still needs to 
make a Startup instance, assign it a location somewhere in 
the row, get user input, and when all of the Startup’s cells 
have been hit, the game is over. This simplified version 

of the game gives us a big head start on building the full 
game. If we can get this small 


one working, we can scale it up SimpleStartupGame 


to the more complex one later. 


In this simple version, the game SimpleStartup 
class has no instance variables, 
and all the game code is in the 
main() method. In other words, 
when the program is launched 
and main() begins to run, it will 
make the one and only Startup 
instance, pick a location for it 
(three consecutive cells on the 
single virtual seven-cell row), ask 
the user for a guess, check the 
guess, and repeat until all three cells have 
been hit. 


int [] locationCells 
int numOfhits 


Keep in mind that the virtual row is...vertual. In other 
words, it doesn’t exist anywhere in the program. As long 
as both the game and the user know that the Startup 

is hidden in three consecutive cells out of a possible 
seven (starting at zero), the row itself doesn’t have to be 
represented in code. You might be tempted to build an 
array of seven ints and then assign the Startup to three 
of the seven elements in the array, but you don’t need to. 
All we need is an array that holds just the three cells the 
Startup occupies. 
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String checkYourself(int guess) 


void setLocationCells(int] loc) 


Game starts and creates ONE Startup 
and gives it a location on three cells in 
the single row of seven cells. 


Instead of “A2," "C4," and so on, the 
locations are just integers (for example: 
1,2,3 are the cell locations in this 
picture): 


2) Game play begins. Prompt user for 


a guess; then check to see if it hit 
any of the Startup's three cells. 
If a hit, increment the numOfHits 
variable. 


(3) Game finishes when all three cells have 


been hit (the numOfHits variable val- 
ue is 3), and the user is told how many 
guesses it took to sink the Startup. 


A complete game interaction 
Sjava SimpleStartupGame 
enter a number 2 
hit 
enter a number 
hit 
enter a number 
miss 
enter a number 
kill 


You took 4 guesses 


Developing a Class 


As a programmer, you probably have a methodology/ 
process/approach to writing code. Well, so do we. Our 
sequence is designed to help you see (and learn) what we’re 
thinking as we work through coding a class. It isn’t necessarily 
the way we (or you) write code in the Real World. In the Real 
World, of course, you'll follow the approach your personal 
preferences, project, or employer dictate. We, however, can 
do pretty much whatever we want. And when we create a 
Java class as a “learning experience,” we usually do it like 
this: 


O Figure out what the class is supposed to do. 


O 


List the instance variables and methods. 


O Write prep code for the methods. (You'll see 
this in just a moment.) 


Write test code for the methods. 
Implement the class. 
Test the methods. 


Debug and reimplement as needed. 


OO aoa 0 


Express gratitude that we don't have to test 
our so-called learning experience app on 
actual live users. 


writing a program 


The three things we'll write for 
each class: 


prep code test code 


This bar is displayed on the next set of pages to tell 
you which part you're working on. For example, if 
you see this picture at the top of a page, it means 
you're working on prep code for the SimpleStartup 
class. 


SimpleStartup class 


prep code p~ code 


prep code 


A form of pseudocode, to help you focus on 
the logic without stressing about syntax. 


test code 
A class or methods that will test the real code 
and validate that it's doing the right thing. 


real code 
The actual implementation of the class. This 
is where we write real Java code. 


To Do: 


simpleStartup class 
5 C1 write prep code 
Sk. R Ab R O write test code 
‘PQwWwWER O write final Java code 
Flex those dendrites. si mpleStartupGame 
How would you decide which class or classes class 


to build first, when you're writing a program? 
Assuming that all but the tiniest programs 
need more than one class (if you’re following 
good OO principles and not having one class 
do many different jobs), where do you start? 


O write prep code 
tl write test code {not needed] 


O write fina 


| Java code 
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SimpleStartup class 


prep code code 


SimpleStartup 


int [] locationCells 


int numOfHits 


String checkYourself(int guess) 


void setLocationCells(int{] loc) 
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You'll get the idea of how prep code (our version of pseudocode) works as you read 
through this example. It’s sort of halfway between real Java code and a plain English 
description of the class. Most prep code includes three parts: instance variable 
declarations, method declarations, method logic. The most important part of prep code 
is the method logic, because it defines what has to happen, which we later translate into 
how when we actually write the method code. 


DECLARE an int array to hold the location cells. Call it locationCells. 
DECLARE an int to hold the number of hits. Call it numOfHits and SET it to 0. 


DECLARE a checkYourself() method that takes a int for the user's guess (1, 3, etc.), checks it, 
and returns a result representing a “hit,” “miss,” or “kill.” 


DECLARE a setLocationCells() setter method that takes an int array (which has the three cell 
locations as ints (2, 3, 4, etc.)). 


METHOD: String check Yourself(int userGuess) 

GET the user guess as an int parameter 
-— REPEAT with each of the location cells in the int array 

// COMPARE the user guess to the location cell 
7 IF the user guess matches 

INCREMENT the number of hits 

// FIND OUT if it was the last location cell: 
IF number of hits is 3, RETURN “kill” as the result 


ELSE it was nota kill, so RETURN “hit” 
— FND IF 
ELSE the user guess did not match, so RETURN “miss” 
—END IF 
— END REPEAT 


END METHOD 


METHOD.: void setLocationCells(int[] cellLocations) 
GET the cell locations as an int array parameter 


ASSIGN the cell locations parameter to the cell locations instance variable 


END METHOD 


prep code testcode KETC 


Writing the method 
implementations 


Let’s write the real 
method code now and get 
this puppy working. 


Before we start coding the 
methods, though, let’s back 

up and write some code to 

test the methods. That’s right, 
we're writing the test code before 
there’s anything to test! 


The concept of writing the test 
code first is one of the practices 
of Test-Driven Development 
(TDD), and it can make it easier 
(and faster) for you to write 

your code. We’re not necessarily 
saying you should use TDD, but 
we do like the part about writing 
tests first. And TDD just sounds 
cool. 


writing a program 


Oh my! For a minute 
there I thought you 
weren't gonna write your 
test code first. Whoo! 

Don't scare me like that. 


Test-Driven Development (TDD) 


Back in 1999, Extreme Programming (XP) was a newcomer 
to the software development methodology world. One 

of the central ideas in XP was to write test code before 
writing the actual code. Since then, the idea of writing 
test code first has spun off of XP and become the core of a 
newer, more popular subset of XP called TDD. (Yes, yes, we 
know we've just grossly oversimplified this, please cut us a 
little slack here.) 


TDD is a LARGE topic, and we're only going to scratch the 
surface in this book. But we hope that the way we're going 
about developing the “Sink a Startup” game gives you 
some sense of TDD. 


Check out Test Driven Development: By Example by Kent 
Beck if you want to learn more about how TDD works. 


Here is a partial list of key ideas in TDD: 


Write the test code first. 
Develop in iteration cycles. 
Keep it (the code) simple. 


Refactor (improve the code) whenever and 
wherever you notice the opportunity. 


Don't release anything until it passes all the tests. 


Don't put in anything that’s not in the spec 
(no matter how tempted you are to put in 
functionality “for the future”). 


No killer schedules; work regular hours. 
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SimpleStartup class 


prep code testcode PEIG 


Writing test code for the SimpleStartup class 


We need to write test code that can make a SimpleStartup object and 
run its methods. For the SimpleStartup class, we really care about 
only the checkYourself() method, although we will have to implement the 
setLocationCells() method in order to get the checkYourself() method to run 
correctly. 


Take a good look at the prep code below for the checkYourself() method 
(the setLocationCells() method is a no-brainer setter method, so we’re not 
worried about it, but in a “real” application we might want a more robust 
“setter” method, which we would want to test). 


Then ask yourself, “If the checkYourself() method were implemented, 
what test code could I write that would prove to me the method is 
working correctly?” 


Based on this prep code: Heres what we should test: 
METHOD String check Yourself(int userGuess) 1. Instantiate a SimpleStartup object. 
GET the user guess as an int parameter 2. Assign it a location (an array of 3 ints, like 
REPEAT with each of the location cells in the int array {2, 3, 4}). 
// COMPARE the user guess to the location cell 3. TA an int to represent a user guess (2, 
A 4. Invoke the checkYourself() method passing 
INCREMENT the number of hits it the fake user guess. 
// FIND OUT íf it was the last location cell: 5. Print out the result to see if it’s correct 
IF number of hits is 3, RETURN “Kill” as the result (“passed” or “failed”). 
ELSE it was nota kill, so RETURN “Hit” 
END IF 
ELSE the user guess did not match,so RETURN “Miss” 
END IF 
END REPEAT 
END METHOD 
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prep code testcode EZITE 


there, are_no 


Dumb Questions 


: Maybe I’m missing some- 
thing here, but how exactly do 
you run a test on something 
that doesn’t yet exist!? 


A: You don't. We never said 
you start by running the test; 
you start by writing the test. At 
the time you write the test code, 
you won't have anything to run 
it against, so you probably won't 
be able to compile it until you 
write “stub” code that can com- 
pile, but that will always cause 
the test to fail (like, return null). 


Q: Then I still don’t see the 
point. Why not wait until the 
code is written, and then whip 
out the test code? 


A: The act of thinking 
through (and writing) the test 


code helps clarify your thoughts 
about what the method itself 
needs to do. 


As soon as your implementation 
code is done, you already have 
test code just waiting to validate 
it. Besides, you know if you don't 
do it now, you'll never do it. 
There's always something more 
interesting to do. 


Ideally, write a little test code, 
then write only the implementa- 
tion code you need in order to 
pass that test. Then write a little 
more test code and write only 
the new implementation code 
needed to pass that new test. 

At each test iteration, you run 
all the previously written tests 
to prove that your latest code 
additions don’t break previously 
tested code. 


writing a program 


Test code for the SimpleStartup class 


wate a 
public class SimpleStartupTestDrive { \nstantið ku? 
Simple Star 
public static void main(String[] args) { E jett 


SimpleStartup dot new SimpleStartup () ia 


for 
i vaN 
Make an mt ar khe 
the \otation onset 
rtv sole ! 
int[] locations = {2, 3, me a oat of 3 
dot .setLocationCells (locations); 
Invoke e 
Pe method ih nes 
e 
tart P 
Make a fake 
int userGuess = 2; <— user guess- 
String result = dot .checkYourself (userGuess); 
A Invoke the Cheek Yourself 0) 


method on the Startu 
goject, and pass it the 


€ Ouess. 


String testResult "failed"; 


if (result.equals("hit")) { 


Coen = Wee I£ the fake guess (2) gives 


' back a “hit”, it’s working 


System.out.printin (testResult) ; AK Pri; n 
rin 


aint out the + 
} ( Passed” ov “gear result 


. —_ 

— Sharpen your pencil Yours to solve. 

IN In the next couple of pages we implement the SimpleStartup class, 
and then later we return to the test class. Looking at our test code 
above, what else should be added? What are we not testing in this 
code that we should be testing for? Write your ideas (or lines of 
code) below: 
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SimpleStartup class 


prep code test code 


The checkYourself() method 


There isn’t a perfect mapping from prep code to Java code; you'll see a few adjustments. 
The prep code gave us a much better idea of what the code needs to do, and now we 
have to figure out the Java code that can do the how. 


In the back of your mind, be thinking about parts of this code you might want (or need) 
to improve. The numbers © are for things (syntax and language features) you haven’t 
seen yet. They’re explained on the opposite page. 


GET the user public String checkYourself (int guess) { 


guess Make a variable 
i String result = "miss"; < return. put -o hold the result we'll 


n ae default 


L-E We assume 3 “miss 


REPEAT with 
each cell in the int . A r 
for (int cell : locationCells) { e feat with each a 
IF the user guess i 3 rray leath Cell loe ti n the loeationCell 
matches j 15 (guess ==uceli) i Compare the use ation of the object) 
r 
element (ecli) in e to this J 
result = "hit"; \ e array 
INCREMENT 
the number of nunofHits O, <e got a hit/ 
hits ® 
break; —_ n out of the loop, no need 
est the other tells 
} // end if 
// FIND OUT if } // end for 
it was the last cell 
IF number of hits if (numOfHits == locationCells.length) { 
is 3 
' We've ou 
RETURN “kill” result = "kill"; —. t of the loop, but let’s see if we're 


now ‘dead’ Chit 3 times 
result String to “Kill” 


as the result 


) and change the 


ELSE it was } // end if 

not a kill, so 

RETURN 'hit” System. out .print1n (result); Display the result f TET 
i or the user ( miss 

ELSE uniess it was changed to “hit” or “Kil 

RETURN return result; K Return the result back b 

“miss” the calling method 


} // end method 
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writing a program 


prep code test code 


Just the new stuff 


The things we haven’t seen before are 
on this page. Stop worrying! There are 
more details later in the chapter. This is 
just enough to get you going. 


his for loop declaration as “repeat Th 
A the ‘locationCells wh stelon 6) 
array: take the next element in the array ah 
and assign it Lo the int variable cell’. 


BY, 
@) The for loop for (int cell : locationCells) { } 
a a aaa 


Declare a variable th : -gne loo? 
rom the array. iene hold One element over 0 


(a 
Rs through the | ay t t ae 
ler A s an int arable aa Ti hel ay will be an at the 
"i noid a ditterent element £ $ v 
array, until there are no more Kr i variable a 
tode does a “break”... see #4 below) € the Ihis enayre™ 
4 Wi 


The ++ means add | to 


whatever's there (in other 
@ The post-increment words, intrement by |). 
operator 


numOfHits++ 
numOfHitst++ is the same lin 


this case) as sayin numOfHits = 
numOLHits + L es less typing, 


©) break statement 


break; 


Gets you out of a loop. Immediately. Right here. 
No iteration, no boolean test, just get out now! 
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SimpleStartup class 


prep code Tas Final code for SimpleStartup and SimpleStartupTestDrive 


ther are no public class SimpleStartupTestDrive { 
pum Questions public static void main(String[] args) { 
SimpleStartup dot = new SimpleStartup(); 
int[] locations = {2, 3, 4}; 
Q: In the beginning of the dot.setLocationCells (locations) ; 
book, there was an example of a int userGuess = 2; 
for loop that was really different String result = dot.checkYourself (userGuess) ; 


from this one—are there two 


different styles of for loops? o ring Ceece eee M fallcat; 


if (result.equals("hit")) { 


testResult = "passed"; 
A: Yes! From the first version of } 
Java there has been a single kind System.out.printin(testResult) ; 
of for loop (explained later in this } 
chapter) that looks like this: } 
for (int i = 0; i < 10; i++) 
{ 
// do something 10 times class SimpleStartup { 

} private int[] locationCells; 

j T int OfHits = 0; 
You can use this format for any PTE e oeer geerae E ’ 
kind of loop you need. But... 
since Java 5, you can also use public void setLocationCells(int[] locs) { 
the enhanced for loop (that’s the locationCells = locs; 
official description) when your } 


loop needs to iterate over the 
elements in an array (or another 


kind of collection, as you'll see in public String checkYourself(int guess) { 


the next chapter). You can always String result = "miss"; 
use the plain old for loop to iterate for (int cell : locationCells) { 
over an array, but the enhanced for if (guess == cell) { 
loop makes it easier. fesult = “hir; 
numOfHits++; 

: If you can add one to an int break; What should we see when 
by using ++, can you also subtract } // end if we run this code? 
one in some way? } // end for The test code makes a 


SimpleStartup object 


E e == and gives it a location at 


Å: Yep absolutely. Hopefully it’s locationCells.length) { | 23,4. Then it sends a fake 
not too surprising to find out that result = "kill"; user guess of “2” into the 


the syntax is -- (two minuses), like } // end if checkYouself() method. If the 
code is working correctly, we 
should see the result print 
out: 


this: System.out.println (result); 
countdown = i--; return result; 
} // end method 
} // close class 


% java SimpleStartupTestDrive 
hit 
passed 


There’s a little bug lurking here. It compiles and 
runs, but...don’t worry about it for now, but we will 
have to face it a little later. 
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prep code FE code 
eatery your pencil 
DN 


We built the test class and the SimpleStartup class. But we still haven't made the 
actual game. Given the code on the opposite page and the spec for the actual 
game, write in your ideas for prep code for the game class. We've given you a few The SimpleStartupGame 
lines here and there to get you started. The actual game code is on the next page, needs to do this: 

so don’t turn the page until you do this exercise! 


1. Make the single 
You should have somewhere between 12 and 18 lines (including the ones we wrote, SimpleStartup object. 


but not including lines that have only a curly brace). 2. Make a location for it (three 


consecutive cells on a single 


row of seven virtual cells). 


METHOD public static void main (String [] args) 3. Ask the user for a guess 


DECLARE an int variable to hold the number of user guesses, named numOfGuesses 


4. Check the guess. 


5. Repeat until the Startup is 
sunk. 


6. Tell the user how many 
guesses it took. 


COMPUTE a random number between 0 and 4 that will be the starting location cell position 


A complete game interaction 


%java SimpleStartupGame 


WHILE the Startup is still alive: enter a number 2 
GET user input from the command line hit 
enter a number 3 
hit 
enter a number 4 
miss 
enter a number 1 
kill 


You took 4 guesses 


—> Yours to solve. 
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SimpleStartupGame class 


prep code p~ code 


Prep code for the SimpleStartupGame class 
Everything happens in mainl) 


There are some things you'll have to take on faith. For example, we have one line of 
prep code that says “GET user input from command line.” Let me tell you, that’s a 
little more than we want to implement from scratch right now. But happily, we’re using 
OO. And that means you get to ask some other class/object to do something for you, 
without worrying about how it does it. When you write prep code, you should assume 
that somehow you'll be able to do whatever you need to do, so you can put all your 
brainpower into working out the logic. 


public static void main (String [] args) 
DECLARE an int variable to hold the number of user guesses, named numOfGuesses, and set it to 0 
MAKE a new SimpleStartup instance 
COMPUTE a random number between 0 and 4 that will be the starting location cell position 


MAKE an int array with 3 ints using the randomly generated number, that number incremented by |, 
and that number incremented by 2 (example: 3,4,5) 


INVOKE the setLocationCells() method on the SimpleStartup instance 


DECLARE a boolean variable representing the state of the game, named isAlive. SET it to true 


WHILE the Startup is still alive (isAlive == true): 
GET user input from the command line 
// CHECK the user guess 
INVOKE the checkYourself() method on the SimpleStartup instance 
INCREMENT numOfGuesses variable 
// CHECK for Startup death 
IF result is “kill” 
SET isAlive to false (which means we won't enter the loop again) 


PRINT the number of user guesses 


END IF 
e,e e 
END WHILE metacognitive tip 
END METHOD Don't work one part of the brain for too long a stretch at one time. 


Working just the left side of the brain for more than 30 minutes 
is like working just your left arm for 30 minutes. Give each side 
of your brain a break by switching sides at regular intervals. 


When you shift to one side, the other side gets to rest and 
recover. Left-brain activities include things like step-by-step 
sequences, logical problem-solving, and analysis, while the 
right-brain kicks in for metaphors, creative problem-solving, 
pattern-matching, and visualizing. 
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—— BULLET POINTS 


writing a program 


= Your Java program should start with a high- 
level design. 


=m Typically you'll write three things when you 
create a new class: 


=" prep code 
= test code 
= real (Java) code 


= Prep code should describe what to do, not 
how to do it. Implementation comes later. 


= Use the prep code to help design the test 
code. 


= Aclass can have one superclass only. 


Write test code before you implement the 
methods. 


Choose for loops over while loops when you 
know how many times you want to repeat the 
loop code. 


The enhanced for loop is an easy way to loop 
over an array or collection. 


Use the increment operator to add 1 toa 
variable (x++;). 


Use the decrement operator to subtract 1 from 
a variable (x--;). 


Use break to leave a loop early (i.e., even if 
the boolean test condition is still true). 


How many 
hits did you get 
last month? 


Including 
repeat visitors? 


AYU. 


- i N 
SS 


Aoudy from Ghost Towa 
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SimpleStartupGame class 


prep code test code [i7-\\(fefe (3 F : 
BEz The game’s main() method 


Just as you did with the SimpleStartup class, be thinking about parts of this code you 
might want (or need) to improve. The numbered things © are for stuff we want to point 
out. They’re explained on the opposite page. Oh, if you’re wondering why we skipped 
the test code phase for this class, we don’t need a test class for the game. It has only one 
method, so what would you do in your test code? Make a separate class that would call 
main() on this class? We didn’t bother, we’ll just run this to test it. 


DECLARE a vari- 
able to hold user 
guess count, and set 
it to O 


MAKE a Simple- 
Startup object 


COMPUTE a 
random number 
between 0 and 4 


MAKE an int array 
with the 3 cell loca- 
tions, and 


INVOKE setLo- 
cationCells on the 
Startup object 


DECLARE a bool- 
ean isAlive 


WHILE the 
Startup is still alive 


GET user input 
// CHECK it 


INVOKE checkYo- 
urself() on Startup 


INCREMENT 
numOfGuesses 


IF result is “kill” 
SET isAlive to false 


PRINT the number 
of user guesses 
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public static void main(String[] args) { 


able to track how 


vari 
Make a Ya the user makes: 


many guesses 

This is a special class we wrote that has 
GameHelper helper = new GameHelper(); the method for getting user input. For 
now, pretend it’s part of Java. 


int numOfGuesses = 0; 


SimpleStartup theStartup = new SimpleStartup(); Make the Startup object, 


int randomNum = (int) (Math.random() * 5); Make a vandom number £ h 
T—— first cell, and use it to eh ° 
ea the cell locations array. 


int[] locations = {randomNum, randomNum + 1, randomNum + 2}; 


: its locations 
theStartup.setLocationCells (locations); ¢— Give the Ta i 
(the array). 


boolean isAlive = true; 


Ê~ Make a boolean variable to track whether the 
game is still alive, to use in the while loop test. 


pa repeat while game is still alive. 
while (isAlive) { © , n Gert user guess: 


int guess = helper.getUserInput ("enter a number"); 


String result = theStartup.checkYourself (guess) ; 


<~ Ask the Sta 
: Inerement guess rtup to cheek th 
numOfGuesses++; <—— aia by cs e 
if (result.equals("kill")) { 
n_ Was it a “kill”? if So, set isAli ) 
isAlive = false; ——____ re-enter the loop) and AEE hi 


System. out .printi1n ("You took " + numOfGuesses + " guesses"); 
} // close if 


} // close while 


writing a program 


prep code test code 


random() and getUserlnput() This is a east’, and it fortes the 4 
and it Tortes the thing 


Two things that need a bit more ex- nna sri after it to become the 

plaining are on this page. This is just pire or the cast (ie, the type in the The Math.random method oo 

a quick look to keep you going; more ee Math.random returns a turns a number from yM J 

details on the GameHelper class are at (we w arpa anes T . int lee Dn ae yee : pem 

the end of this chapter O and 4). In this case, the ad ie or O to % lie, O- 411 
off the fractional part of the PAA zast to an int). 


Make a random 


number l 


int randomNum = (int) CMath.random() * 5) 


We declare an int variable to hold 7 
the random number we get back. i T comes Ne aig of 


Math.random() has been around forever, so you’]] see code 
like this in the Real World. These days you can use 
java.uti].Random's nextInt() method instead, which is more 
convenient (you don’t have to cast the result to an int). 


The Random class is in a different package. Since we 
haven’t covered importing packages yet (it’s in the next 
chapter), we've used Math.random() instead. 


od 
argument as a String 
S 


the user use. 
at Prompt 
An instance we made earlier disp} ver You oe d line, p 
of a class that we built to be ayed in the tern: E Jets 
help with the game. It’s called a ore the m ethed i just 
Getting user input  Gamettelper and you haven't “Ser input, rts looking 
© using the GameHelper seen it yet (you will). 
class / 
int guess = helper.getUserInput ("enter a number"); 
We à . A method of the Gamettelper class 
teats ani int variable to that asks the user for command- 
he user input we oet b k eee dinal 
(3, 5, ete). get bae line input, reads it in after the 
user hits RETURN, and gives back 
the result as an int. 
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GameHelper class (Ready-bake) 


prep code test code 


One last class: GameHelper 


We made the Startup class. Just copy* the code below and compile it into a 

class named GameHelper. Drop all three class files 
(SimpleStartup, SimpleStartupGame, GameHelper) into 
the same directory, and make it your working directory. 


We made the game class. 


All that’s left is the helper class—the one with the 
getUserInput() method. The code to get command-line 
input is more than we want to explain right now. It opens 
up topics best left for later. (Later, as in Chapter 16, Saving 
Objects.) 


Yes, we WILL 
take a little more 
of your delicious 
Ready-Bake Code, 
thank you very much! 


import java.util.Scanner; 


public class GameHelper { 
public int getUserInput (String prompt) { 
System.out.print (prompt + ": "); 
Scanner scanner = new Scanner (System.in) ; 


return scanner.nextInt(); 


“We know how much you enjoy typing, but for those rare moments 
when you'd rather do something else, we’ve made the Ready-Bake 
Code available on https://oreil.ly/hfJava_3e_examples. 


112 chapter 5 


writing a program 


Let’s play What's this? A bug? 


Gasp! 
Heres what happens when we Here's what happens when we 
run it and enter the numbers enter 111 
1,2,3,4,5,6. Lookin’ good. es 
A complete game interaction A different game interaction 
(your mileage may vary) (yikes) 


File Edit Window Help Faint 


Sjava SimpleStartupGame 


File Edit Window Help Smile 


Sjava SimpleStartupGame 
enter a number 1 


hit 


enter a number 1 
miss 
enter a number 1 


hit 


enter 
miss 

enter enter a number 1 
miss kill 
enter You took 3 guesses 


hit 


enter 


hit 


taherpe your pencil 
: DN 

} It’s a cliff-hanger! 
Will we find the bug? 

Will we fix the bug? 


enter 


kill 


You took 6 guesses 


Stay tuned for the next chapter, where we answer 
these questions and more... 


And in the meantime, see if you can come up with 
ideas for what went wrong and how to fix it. 


—+> Yours to solve. 
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for loops 


More about for loops 


We've covered all the game code for this chapter (but we'll pick it up again to finish 
the deluxe version of the game in the next chapter). We didn’t want to interrupt 
your work with some of the details and background info, so we put it back here. 
We'll start with the details of for loops, and if you’ve seen this kind of syntax in 
another programming language, just skim these last few pages... 


Regular (non-enhanced) for loops 


the Cod e to 
repeat goes Fer 
post—inerement we the body) i 
for Cint i = 0; i < 100; i++) { } repeat for 100 reps: 
wo o 
f 
initialization Boolean test iteration expression 


What it means in plain English: “Repeat 100 times.’ 
How the compiler sees it: 

a create a variable i and set it to 0. 

a repeat while i is less than 100. 


a at the end of each loop iteration, add 1 to i. 


Part One: initialization 


Use this part to declare and initialize a variable to use within the loop body. 
You'll most often use this variable as a counter. You can actually initialize more 
than one variable here, but it's much more common to use a single variable. 


Part Two: boolean test 


This is where the conditional test goes. Whatever's in there, it must resolve to a 
boolean value (you know, true or false). You can have a test, like (x >= 4), or you 
can even invoke a method that returns a boolean. 


Part Three: iteration expression 


In this part, put one or more things you want to happen with each trip through 
the loop. Keep in mind that this stuff happens at the end of each loop. 
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writing a program 


Trips through a loop © 


for (int i = 0; i < 8; i++) { %java Test 
System. out .println (i) ; 
} 


System.out .printin ("done"); 


declare int i 
set i toO 


enter loop 
body 


print the value 
of i 


++ =- 


Pre and Post Increment/Decrement Operator 


print “done” The shortcut for adding or subtracting 1 from a variable: 


(jump below loop) xt++; 
increment i is the same as: 
(the iteration x=x + 1 F 


expression) 
They both mean the same thing in this context: 


“add 1 to the current value of x” or “increment x by 1” 


Difference between for and while And 
a > : 
x--; 
A while loop has only the boolean test; it doesn't have f 
a built-in initialization or iteration expression. A while is the same as: 
loop is good when you don't know how many times to x = x — 1 z 


loop and just want to keep going while some condi- 
tion is true. But if you know how many times to loop 
(e.g., the length of an array, 7 times, etc.), a for loop is 
cleaner. Here’s the loop above rewritten using while: 


Of course that’s never the whole story. The placement of the 
operator (either before or after the variable) can affect the re- 
sult. Putting the operator before the variable (for example, ++x), 
means, “first, increment x by 1, and then use this new value of x.’ 
This only matters when the ++x is part of some larger expres- 
sion rather than just a single statement. 


i = 0: we h 

ante i =O; me er declare and 
; : ize the count int x = 0; int z = ++x; 

while (i < 8) { er 


produces: xis1,zis 1 
System. out .println (i); 


i++; <—— ha have to in 


But putting the ++ after the x gives you a different result: 


ĉr i = 0; i = ; 
i e Coun Lip ement int x 0; int z x++; 
Once this code has run, xis 1, but zis 0! z gets the value of x, 
System.out.printl1n ("done"); and then x is incremented. 
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enhanced for 


The enhanced for loop 


The Java language added a second kind of for loop called the enhanced for back in Java 

5. This makes it easier to iterate over all the elements in an array or other kinds of 
collections (you'll learn about other collections in the next chapter). That’s really all that the 
enhanced for gives you—a simpler way to walk through all the elements in the collection. 
We'll see the enhanced for loop in the next chapter too, when we talk about collections 
that arent arrays. 


. The Cod 
akeration T repeat ao. z 
elare an "Y old 3 he Colon (. Prat goes h 
Karae Oat the array: medns ye? “the body) , üi 
mole elem 
sin) 


for (String name : nameArray) K } 
: ou want to iterate over: 


The el ; ‘ kion, à : Jements that y oe 
cay pi be the With eath ae? a mthe The aes a pee earlier, the tode said 

i c Fleret 7 e T ed to |magine t 3 D) a n “B b}; 
Compatible with the °°) be a559% = {"Fred”, “Mary’ “Bob 3; 


declared vari able type. array wi WE “name - String lI namefirray has the value of 
ote With the first iteration, the name variable - of “Mary”, ett- 


iteration, a Va 
“Fred”, and with the second iteratio 


What it means in plain English: “For each element in nameArray, assign the 
element to the ‘name’ variable, and run the body of the loop.” 


How the compiler sees it: ties rink hs 
Programming language they've 
a Create a String variable called name and set it to null. used in the Past, some people 
refer to the enhanced for as the 
or each or the “for in” loo A 
a Run the body of the loop (the code block bounded by curly braces). FN that’s how it reads: E, 
ACH thing IN the collection...” 


a Assign the first value in nameArray to name. 


a Assign the next value in nameArray to name. 


a Repeat while there are still elements in the array. 


Part One: iteration variable declaration 


Use this part to declare and initialize a variable to use within the loop body. With each 
iteration of the loop, this variable will hold a different element from the collection. The 
type of this variable must be compatible with the elements in the array! For example, 
you can't declare an int iteration variable to use with a String[] array. 


Part Two: the actual collection 


This must be a reference to an array or other collection. Again, don't worry about the 
other non-array kinds of collections yet—you'll see them in the next chapter. 
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writing a program 


Casting primitives 


Before we finish the chapter, we want to tie up a loose end. When we used Math.random(), 
we had to cast the result to an int. Casting one numeric type to another can change the value 
itself. It's important to understand the rules so you’re not surprised by this. 


long ———_—__—___» short 
g can be cast to 


Bits on 
. th 
KA v “de were neat 
of but you might L190 


lose something 0 


In Chapter 3, Anow Your Variables, we talked about the sizes of the various primitives and how you can’t shove a big 
thing directly into a small thing: 

long y = 42; 

int x = y; // won't compile 
A long is bigger than an int, and the compiler can’t be sure where that long has been. It might have been out 
partying with the other longs, and taking on really big values. To force the compiler to jam the value of a bigger 
primitive variable into a smaller one, you can use the cast operator. It looks like this: 


long y = 42; // so far so good 

int x = (int) y; // x = 42 cool! 
Putting in the cast tells the compiler to take the value of y, chop it down to int size, and set x equal to whatever is 
left. If the value of y was bigger than the maximum value of x, then what’s left will be a weird (but calculable*) 
number: 

long y = 40002; // 40002 exceeds the 16-bit limit of a short 

short x = (short) y; // x now equals -25534! 
Still, the point is that the compiler lets you do it. And let’s say you have a floating-point number and you just want 
to get at the whole number (int) part of it: 

float f = 3.14f; 

int x = (int) f; // x will equal 3 
And don’t even think about casting anything to a boolean or vice versa—just walk away. 


*It involves sign bits, binary, “two’s complement,” and other geekery. 
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exercise: Be the JVM 


class Output { 


public static void main(String[] args) { 


Output output = new Output (); 


output.go(); 


void go() { 
int value = 7; 
for (int i= 1; i < 8; itt) { 
value++; 
if (i > 4) { 


System.out.print(++value + " 
} 
if (value > 14) { 
System.out.printin(" 


break; 


————> Answers on page 122. 
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BE the JVM. 


The Java file on this page 
represents a complete source 
file. Your job is to play JVM 


the output when the 
program runs. 


File Edit Window Help OM 


% java Output 
12 14 


-or- 


File Edit Window Help Incense 


% java Output 
12 14 x = 6 


i=" +i); 


-0r- 


File Edit Window Help Believe 


% java Output 
13 15 x = 6 


writing a program 


Code Magnets 


A working Java program is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working Java program that 
produces the output listed below? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as many of 
those as you need! 


if (i == 1) { 


System.out.printlIn(i + " "+ j); 


for (int 


for(int i = 0; i < 4; i++) { 


File Edit Window Help Raid 


java MultiFor 


———— Answers on page 122. 
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puzzle: JavaCross 


JavaCrass 


How does a crossword puzzle 
help you learn Java? Well, all 
of the words are Java related. 


In addition, the clues provide 
metaphors, puns, and the like. 


These mental twists and turns 
burn alternate routes to Java 


knowledge right into your 


Across 


1. Fancy computer word 
for build 


4, Multipart loop 

6. Test first 

7. 32 bits 

10. Method's answer 
11. Prep code-esque 
13. Change 

15. The big toolkit 
17. An array unit 


18. Instance or local 
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20. Automatic toolkit 


22. Looks like a primi- 
tive, but.. 


25. Un-castable 
26. Math method 
28. Iterate over me 


29. Leave early 


brain! 
Down 
2. Increment type 21. As if 
3. Class’s workhorse 23. Add after 
5. Preisatypeof_ 24. Pi house 
6. For'siteration 26. Compile itand___ 
7. Establish first value 27. ++ quantity 
8. While or For 
9. Update an instance variable 


12. Toward blastoff 
14. Acycle 
16. Talkative package 


19. Method messenger 
(abbrev.) 


————> Answers on page 123. 


writing a program 


A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left) with the output that you'd see if the block 

3 were inserted. Not all the lines of output will be used, and some 
Mixed of the lines of output might be used more than once. Draw lines 
Messages connecting the candidate blocks of code with their matching 
command-line output. 


—— Answers on page 123. 


public static void main(String[] args) { 


int x = 0; 
int y = 30; 
for (int outer = 0; outer < 3; outer++) { 
for (int inner = 4; inner > 1; inner--) { 
fF ei Candid 
at 
y= y = Joes ie 
if (x == 6) { 
break; 
} 
x = x + 3; 
} 
Sy S25 
} 
System.out.printin(x + " " + y); 
} 
Candidates: Possible output: 
Sa ee acy 45 6 Matth eath 
candidate yee 
mm = oe a 68 Ie 6 one of the Pos 
outputs 
SS ae Dp 54 6 
Rete 60 10 
x--; Ie © 
= & + Op 6 14 
12 Ia 
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exercise solutions 


Exercise Solutions 


Be the JVM (from page 118) Code Magnets (from page 119) 
class Output { class MultiFor { 
public static void main(String[] args) { public static void main(String[] args) { 
Output output = new Output (); for (int i= 0; i < 4; i++) { 
output.go(); 
} for (int j = 4; j > 2; j--) { 
System.out.printin(i + " " + j); 
void go() { } 


int value = 7; 
for (int i= 1; i < 8; i++) { 


value++; 
if (2 > 4) 4 What would happen if 
System. out.print (++value + " "); } this code block came 
} ; before the 'j' for loop? 
if (value > 14) { } 
System.out.printin(" i = " + i); 
break; File Edit Window Help Monopole 
} java MultiFor 


Did you remember to factor in 
} the break statement? How did 
that affect the output? 


File Edit Window Help MotorcycleMaintenance 


% java Output 
13 15 x 
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P [5 
| R O 
E E P I 
> D E N 
E D R I E 
E T C I T I (from page 120) 
S T| R O A 
s| TJELE T R L 
I R M I 
O| A| E V A Z 
N TN I E 
“INT R 
O T B E 
RANDO U 
U N ‘A 
N B E L 
Mixed 
Messages (from page 121) 
Candidates: Possible output: 
x = x + 3; AS G 
xX = xX + 6; 36 6 
x = x + 2; 54 6 
XFF}; 60 10 
X--; 18 6 
x = x + 0; 6 14 
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6 get to know the Java API 


Using the Java Library 


So 
it's true? We 
don't have to build 
it ourselves? 


Java ships with hundreds of prebuilt classes. You don't have to reinvent 
the wheel if you know how to find what you need in the Java library, known as the Java API. 
You've got better things to do. If you're going to write code, you might as well write only the 
parts that are truly custom for your application. You know those programmers who walk out 
the door each night at 5 PM? The ones who don't even show up until 10 AM? They use the 
Java API. And about eight pages from now, so will you. The core Java library is a giant pile of 
classes just waiting for you to use like building blocks, to assemble your own program out of 
largely prebuilt code. The Ready-Bake Java we use in this book is code you don't have to create 
from scratch, but you still have to type it. The Java API is full of code you don’t even have to 


type. All you need to do is learn to use it. 
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we still have a bug 


In our last chapter, we left you 
with the cliffhanger: a bug 


How it’s supposed to look How the bug looks 
Here's what happens when we Here's what happens when we 
run it and enter the numbers enter 2,2,2. 


1,2,3,4,5,6. Lookin’ good. 


A complete game interaction A different game interaction 
(your mileage may vary) (yikes) 


File Edit Window Help Faint 


Sjava SimpleStartupGame 


%java SimpleStartupGame 


enter a number 1 enter a number 2 


miss hit 
enter enter a number 2 
miss hit 

enter a number 2 


kill 


enter 
miss 


enter You took 3 guesses 


hit 
enter 
hit In the current version, once 
enter you get a hit, you can simply 
kill repeat that hit two more 
You took 6 guesses times for the kill! 
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So what happened? 


Here’s where it 
goes wrong. We 


counted a hit every =} 


time the user 
guessed a cell 
location, even if 
that location had 
already been hit! 


We need a way to 
know that when 

a user makes a 

hit, they haven’t 
previously hit that 
cell. If they have, 
then we don’t want 
to count it as a hit. 


public String checkYourself (int guess) { 


Make a variabl 
String result = "miss"; — we'll v ş to hold the resul 
eturn. Put miss” in as the 


default lie, we assume a “miss”). 


for (int cell : locationCells) { 


R 
m re at with eaeh 
9 in the array. 
Een Compare the user 


uess to this ele 
Deel), in the weay. : 


if (guess == cell) { 


result = "hit"; 


we got a hit! 
numOfHits++; <—— 


break; <~ Get out of +h ; 
to dest the other ho need 


} // end if 
} // end for 


if (numOfHits == locationCells.length) { <~ Were out of the | but 
j oop, u 


ets see it were now ‘dead’ 
(hit 3 times) and change the 
result String to “kill”. 


result = "kill"; 
} // end if 
System.out .printin (result) ; <__ Display the result for the user (“miss” 
unless it was changed to “hit” or “kill”). 
return result; 


K Return the result back to 


the calling method. 
} // end method 
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fixing the bug 


How do we fix it? 


We need a way to know whether a cell has already been hit. Let's run 
through some possibilities, but first, we'll look at what we know so far... 


We have a virtual row of seven cells, and a Startup will occupy three 
consecutive cells somewhere in that row. This virtual row shows a 
Startup placed at cell locations 4, 5, and 6. 


The Startup has an instance variable—an int array—that holds that 
Startup object's cell locations. 


4 5 6 
The arra insta 
7 vance vari 
ae Startup cell locat, ble that: holds 
locationCells rtup holds th ons. This 
(instance variable of 0 | 1 | 2 » and & Thos € three values of 4 
the Startup) user n € are the numb 
p eeds to guess. ers th 


@) Option one 
We could make a second array, and each time the user makes a hit, we 


store that hit in the second array, and then check that array each time 
we get a hit, to see if that cell has been hit before. 


A rue’ ina 


iq the cll location at tot na, th array means tht 


array (locationCells) has E re in the OTHER 


false false true 


This arr, 
e ( 


E~ ay h 

hitCells array A u the ‘stat yroa: three values representing 
(this would be a | | | | location cells a tartup’s 
new boolean array 0 1 2 - at index 2 is p: ei rample if the 
instance variable of he “hit » nen set index 2 ; 
the Startup) motel array to ‘true’, en 
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Option one is too clunky 


Option one seems like more work than you'd expect. It means that each 
time the user makes a hit, you have to change the state of the second 
array (the hitCells array), oh—but first you have to CHECK the hitCells 
array to see if that cell has already been hit anyway. It would work, but 
there's got to be something better... 


Option two 
We could just keep the one original array but change the value of any hit 
cells to -1. That way, we only have ONE array to check and manipulate. 


a -l ata arti . 
cate is fa ae tell location means that the cell 


-1 negative numbers in the aay only looking or non— 


locationCells 
(instance variable of 
the Startup) 


Option two is a little better, but 
still pretty clunky 


Option two is a little less clunky than option one, but it's not very efficient. You'd 
still have to loop through all three slots (index positions) in the array, even if 
one or more are already invalid because they've been “hit" (and have a -1 value). 
There has to be something better... 
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prep code 


prep code test code 


@) Option three 


We delete each cell location as it gets hit and then modify the array to 
be smaller. Except arrays can't change their size, so we have to make a 
new array and copy the remaining cells from the old array into the new 


smaller array. 
4 5 6 


locationCells array 

BEFORE any cells of 3 with a size 

have been hit (positi co all 3 cells 
Y? to look for 


the tell aa Suess and 


locationCells array 
AFTER cell '5', which 
was at index 1 in the 


array, has been hit 4 
| (0) | 1 | 


Option three would be much better if the array could shrink so that we wouldn't have to 
make a new smaller array, copy the remaining values in, and reassign the reference. 


A 6 When ¢ell S’ is hit, we make a new 


Smaller array with onl i 
tng tell locations, ard i it eo 
original locationCells reference. ° 


The original prep code for part of the Life would be good if only we could 
checkYourself() method: change it to: 
REPEAT with each of the location cells in the int array — REPEAT with each of the remaining location cells 
// COMPARE the user guess to the location cell // COMPARE the user guess to the location cell 
IF the user guess matches IF the user guess matches 
INCREMENT the number of hits = REMOVE this cell from the array 
/I FIND OUT if it was the last location cell: // FIND OUT if it was the last location cell: 
IF number of hits is 3, RETURN “kill” = IF the array is now empty, RETURN “kill” 
ELSE it was not a kill, so RETURN “hit” ELSE it was not a kill, so RETURN “hit” 
END IF END IF 
ELSE user guess did not match, so RETURN “miss” ELSE user guess did not match, so RETURN “miss” 
END IF END IF 
END REPEAT END REPEAT 
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If only I could find an array 
that could shrink when you remove 
something. And one that you didn't have 
to loop through to check each element, but 
instead you could just ask it if it contains 
what you're looking for. And it would let you 
get things out of it, without having to know 
exactly which slot the things are in. 
That would be dreamy. But I know it's 
just a fantasy... 
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when arrays aren’t enough 


Wake up and smell the library 


As if by magic, there really is such a thing 
But it’s not an array, it’s an ArrayList 


A class in the core Java library (the API) 


The Java Platform, Standard Edition (Java SE) ships with hundreds of pre- 
built classes. Just like our Ready-Bake Code. Except that these built-in classes 
are already compiled. 


That means no typing 


Just use ’em. 


addlE e) 


is list. 
d of this lis 
h specified element to the en 
ppendst e 


ArrayList is one of a 


gazillion classes in the Java 
library. 


bes osition. 
sensi sea nt at the specified p 
ee 
Re emoy vest 


You tan use it in your tode 
as if you wrote it yourself 


nt. 
cified eleme 
remove(Ob ws aoe occurrence of the spe 
e 
Re emov be 


; nt. 
to) . ecified eleme 
containslObje a jist contains the SP 
Returns true 


. elements. 
isempty0 "true" if the list contains n° 
Retur 


indexOf (objec 


+ or-1- 
e element, 
ith me first index of th 
Returns € 


; is list. 
: nts in this 
size\) ber of eleme 
he num 
Returns t 


(Note: the add(E e) method looks 
a little strange...we'll get to ig: a 
Chapter II. 


or now, 


ust think of 
as an add() method aise takes th 
object You want to add.) 


on osition. 
get(int index ne element at the specified P 
Returns t 


€ 
This is just a sample of SOM 


of the methods in PrvayList: 
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Some things you can do with ArrayList 


© 


© 


isn > anale-bracket syntax, 
a a pa saree a et of E99 objects: 


Make one va right now; ìt just w f 
i i = , f vtt is 
ArrayList<Egg> myList new ArrayList<Egg>(); hae pera oe ttle 


treated on 
it’s em N: 
Put something in it because ' 


Egg eggl = new Egg(); Q = | 
/ Now the PrerayList grows a box 


myList.add(egg1) ; to hold the E99 object: 


Put another thing in it 


Egg egg2 = new Egg(); The ArrayList ay 

te tod Eg S89 th 
myList.add(egg2) ; 
Find out how many things are in it The ArrayList is holding, L objects so 
int theSize = myList.size(); the sizel) method returns 2: 

The ArrayList DOES contain the Eog object 
Find out if it contains something eeintea by ‘egal’, so tontainsl) returns 
boolean isIn = myList.contains (egg1); true. 
—_— 


List is zero—based (means First index is 0) 


Find out where something is (i.e., its index) wie re the abject velerented by ‘egg’ was the 
and sin 

pe eae el ee ieee ee eae second thing in the list, indexO£0 returns Le 

Find out if it's empty its definitely NOT empty, so isEmpty() 


boolean empty = myList.isEmpty () ; p returns alse. 


Remove something from it / Hey look — it shrank! 


myList.remove (egg1) ; 
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when arrays aren’t enough 


erp your pencil Fill in the rest of the table below by looking at the ArrayList code 


on the left and putting in what you think the code might be if it 
were using a regular array instead. We don’t expect you to get all 
of them exactly right, so just make your best guess. 


ArrayList Regular array 


ArrayList<String> ‘Chane new String CJ myList = = new Stringl2J; 
ArrayList<String> () 
String a "whoohoo"; String a = “whoohoo”: 
= ) 
String b = "Frog"; String b= “Frog”; 


boolean isIn = myList.contains ( 
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thereareno 
b Questions 


* So ArrayList is cool, but 
how would | know it exists? 


A: The question is really, 
“How do | know what's in the 


API?” and that’s the key to your 
success as a Java programmer. 
Not to mention your key to 
being as lazy as possible while 
still managing to build software. 
You might be amazed at how 
much time you can save when 
somebody else has already done 
most of the heavy lifting and 

all you have to do is step in and 
create the fun part. 


But we digress...the short answer 
is that you spend some time 
learning what's in the core API. 
The long answer is at the end of 
this chapter, where you'll learn 
how to do that. 


Q: But that’s a pretty big 
issue. Not only do I need to 
know that the Java library 
comes with ArrayList, but more 
importantly | have to know 
that ArrayList is the thing that 
can do what I want! So how 

do | go from a need-to-do- 
something to a-way-to-do-it 
using the API? 


A: Now you're really at the 
heart of it. By the time you've 
finished this book, you'll have 

a good grasp of the language, 
and the rest of your learning 
curve really is about knowing 
how to get from a problem to 

a solution, with you writing the 
least amount of code. If you can 
be patient for a few more pages, 
we start talking about it at the 
end of this chapter. 
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Java Exposed 


This week’s interview: 
ArrayList, on arrays 


HeadFirst: So, ArrayLists are like arrays, right? 
ArrayList: In their dreams! J am an object, thank you very much. 


HeadFirst: If I’m not mistaken, arrays are objects too. They live on the heap right 
there with all the other objects. 


ArrayList: Sure arrays go on the heap, duh, but an array is still a wanna-be 
ArrayList. A poser. Objects have state and behavior, right? We’re clear on that. But 
have you actually tried calling a method on an array? 


HeadFirst: Now that you mention it, can’t say I have. But what method would I 
call, anyway? I only care about calling methods on the stuff I put in the array, not 
the array itself. And I can use array syntax when I want to put things in and take 
things out of the array. 


ArrayList: Is that so? You mean to tell me you actually removed something from an 
array? (Sheesh, where do they train you guys?) 


HeadFirst: Of course I take something out of the array. I say Dog d = dogArray[1], 
and I get the Dog object at index | out of the array. 


ArrayList: Alright, Pl try to speak slowly so you can follow along. You were not, I 
repeat not, removing that Dog from the array. All you did was make a copy of the 
reference to the Dog and assign it to another Dog variable. 


HeadFirst: Oh, I see what you’re saying. No, I didn’t actually remove the Dog 
object from the array. It’s still there. But I can just set its reference to null, I guess. 


ArrayList: But I’m a first-class object, so I have methods, and I can actually, you 
know, do things like remove the Dog’s reference from myself, not just set it to null. 
And I can change my size, dynamically (look it up). Just try to get an array to do that! 


HeadFirst: Gee, hate to bring this up, but the rumor is that you’re nothing more 
than a glorified but less-efficient array. That in fact you’re just a wrapper for an 
array, adding extra methods for things like resizing that I would have had to write 
myself. And while we’re at it, you can’t even hold primitives! Isn’t that a big limitation? 


ArrayList: I can’t believe you buy into that urban legend. No, I am not just a less- 
efficient array. I will admit that there are a few extremely rare situations where an 
array might be just a tad, I repeat, tad bit faster for certain things. But is it worth the 
miniscule performance gain to give up all this power? Still, look at all this flexibility. And 
as for the primitives, of course you can put a primitive in an ArrayList, as long as it’s 
wrapped in a primitive wrapper class (you'll see a lot more on that in Chapter 10). 
And if you’re using Java 5 or above, that wrapping (and unwrapping when you take 
the primitive out again) happens automatically. And alright, Pll acknowledge that yes, 
if youre using an ArrayList of primitives, it probably is faster with an array, because 
of all the wrapping and unwrapping, but still...who really uses primitives these days? 


Oh, look at the time! Pm late for Pilates. We'll have to do this again sometime. 


youarehere> 135 


difference between ArrayList and array 


Solution 
@e Sharpen your pencil (from page 134) 
all 


ArrayList Regular array 


ArrayList<String> myList = new String [] myList = new String[2]; 
ArrayList<String>(); 


String a = "whoohoo"; String a = "whoohoo"; 
myList.add(a); myList[0] = a; 

String b = "Frog"; String b = "Frog"; 
myList.add(b) ; myList[1] = b; 


myList .remove [a myList [ | 


boolean isIn = myList.contains(b); boolean isIn = false; 


for (String item : myList) { 
if (b.equals(item)) { 
isIn = true; 


break; 


Notice how with ArrayList, you’re working with With an array, you use special array syntax (like 

an object of type ArrayList, so you’re just invoking myList[0] = foo) that you won’t use anywhere else 
regular old methods on a regular old object, using except with arrays. Even though an array is an 
the regular old dot operator. object, it lives in its own special world, and you 


can’t invoke any methods on it, although you can 
access its one and only instance variable, length. 
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© A plain old array has to know its 


size at the time it’s created. 


But for ArrayList, you just make an object of type 
ArrayList. Every time. It never needs to know how 
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Comparing ArrayList to a regular array 


© Arrays use array syntax that’s not 


used anywhere else in Java. 


But ArrayLists are plain old Java objects, so they 
have no special syntax. 


big it should be, because it grows and shrinks as mytistiij 
objects are added or removed. X 


new String[2] Needs a size- The array brackets CJ ave special syn- 


tax used only for arrays: 
new ArrayList<String> () 
No size required (although You tan 
give it an initial size if You want to). 


© ArrayLists are parameterized. 
© To put an object in a regular array, 


you must assign it to a specific We just said that unlike arrays, ArrayLists have 


no special syntax. But they do use something 


location. “ae i 8 
(An index from 0 to one less than the length of aT 
the array.) ArrayList<String> 
myList[1] = b; 
~ The <String> in angle brackets is a “type 
Needs an index- erage ArrayList<String> means simply “a 


of Strings,” as opposed to ArrayList<Dog>, 
which means, “a list of Dogs.” 


If that index is outside the boundaries of the array 
(like the array was declared with a size of 2, and 
now you're trying to assign something to index 3), 
it blows up at runtime. 

With ArrayList, you can specify an index using the 
add(anInt, anObject) method, or you can just keep 
saying add(anObject) and the ArrayList will keep 
growing to make room for the new thing. 

myList .add(b) ; 


No index. 


Using the <TypeGoesHere> syntax, we can 
declare and create an ArrayList that knows 
(and restricts) the types of objects it can hold. 
We'll look at the details of parameterized types 
in ArrayLists in Chapter 11, Data Structures, 

so for now, don’t think too much about the 
angle bracket <> syntax you see when we use 
ArrayLists. Just know that it’s a way to force the 
compiler to allow only a specific type of object 
(the type in angle brackets) in the ArrayList. 


*Parameterized types were added to Java in Java 
5, which came out so long ago that you are almost 
definitely using a version that supports them! 
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the buggy Startup code 


prep code test code 


Let’s fix the Startup code 


Remember, this is how the buggy version looks: 
ass Startup now (instead a rie 


kK. We've renamed the el anced version, 
class Startup { CimpleStartup), for the ne chapter- 


is the same tode you saw n 


private int[] locationCells; 
private int numOfHits = 0; 


public void setLocationCells(int[] locs) { 


locationCells = locs; 


public String checkYourself(int guess) { 


String result = "miss"; 
for (int cell : locationCells) { 
if (guess == cell) { Where it all w 
mecwuhe = Hinke e go Counted ath a Wrong. We 
numOfHits++; without chee, : “ss as a hit, 
tell had already beer fre rae 
break; a 


} 

} // end for 

if (numOfHits == locationCells.length) { 
result = "kill"; 

} // end if 

System.out.printin(result); 

return result; 

} // end method 
} // close class 


138 chapter 6 


get to know the Java API 


prep code test code 


New and improved Startup class 


import Jjava.util.ArrayList; 
public class Startup { 


private ArrayList<String> locationCells; List that holds Strings: 
// private int numOfHits; | Change the int array to an Array 
// don't need to track this now Pi 


public void setLocationCells (ArrayList<String> locs) { 
locationCells = locs; ent name 


This is now â String = it needs o 
' to accept a value like A3. we pes wt 


ayList, by askin dex) 
public String checkYourself (String userInput) { re wee lene list, then indexO 


String result = "miss"; returns a —!- 
int index = locationCells.indexOf (userInput) ; 


If index į 
if (index >= 0 4 €X IS greater 
( ) í the user guess is pf or equal to zero, 
remove it nitely in the list, so 
locationCells .remove (index) ; (—— 


i If the list is empty, this 
if (locationCells.isEmpty()) { re the ta re 
result = "kill"; o 
} else { 
result = "hit"; 
} // end if 
} // end outer if 
return result; 
} // end method 
} // close class 
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making the StartupBust 


Let’s build the REAL game: 
“Sink a Startup” 


We've been working on the “simple” version, but now let’s 
build the real one. Instead of a single row, we’ll use a grid. 
And instead of one Startup, we’ll use three. 


Goal: Sink all of the computer’s Startups in the fewest 
number of guesses. You’re given a rating level based on 
how well you perform. 


Setup: When the game program is launched, the 
computer places three Startups, randomly, on the virtual 
7x7 grid. When that’s complete, the game asks for your 
first guess. 


How you play: We haven’t learned to build a GUI yet, 
so this version works at the command line. The computer 
will prompt you to enter a guess (a cell), which you'll type 
at the command line (as “A3,” “C5,” etc.). In response to 
your guess, you'll see a result at the command-line, either 
“hit,” “miss,” or “You sunk poniez” (or whatever the lucky 
Startup of the day is). When you’ve sent all three Startups 
to that big 404 in the sky, the game ends by printing out 
your rating. 


= 


o A D 


N Starte ab savo like Java awaj 
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You’re going to build the 
Sink a Startup game, with 
a 7 x7 grid and three 
Startups. Each Startup 
takes up three cells. 


part of a game interaction 


File Edit Window Help Sell 


%java StartupBust 
Enter a guess A3 
miss 

Enter 

miss 

Enter 

miss 

Enter 

hit 

Enter 

hit 

Enter a guess D4 
Ouch! You sunk poniez 


kill 


Enter a guess G3 
hit 


Enter a guess 

hit 

Enter a guess G5 

Ouch! You sunk hacqi aa | 


All Startups are dead! Your stock 
is now worthless 


Took you long enough. 62 guesses. 


What needs to change? 


We have three classes that need to change: the Startup class 
(which is now called Startup instead of SimpleStartup), the 
game class (StartupBust), and the game helper class (which 
we won't worry about now). 


A) Startup class 


=" Adda name variable 
to hold the name of the Startup (“poniez,” 
“cabista,” etc.) so each Startup can print its 
name when it’s killed (see the output screen on 
the opposite page). 


© StartupBust class (the game) 


= Create three Startups instead of one. 


= Give each of the three Startups a name. 
Call a setter method on each Startup instance 
so that the Startup can assign the name to its 
name instance variable. 
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StartupBust class continued... 


Put the Startups on a grid rather than 
just a single row, and do it for all three 
Startups. 

This step is now way more complex than 
before, if we’re going to place the Startups 
randomly. Since we’re not here to mess with 
the math, we put the algorithm for giving 

the Startups a location into the GameHelper 
(Ready-Bake Code) class. 


Check each user guess with all three 
Startups, instead of just one. 


Keep playing the game (i.e., accepting user 
guesses and checking them with the remaining 
Startups) until there are no more live 
Startups. 


Get out of main. We kept the simple one in 
main just to...keep it simple. But that’s not what 
we want for the real game. 


3 Classes: 


StartupBust 


The game class. The actual 


GameHelper 


The helper class Plus four 


Makes Startups, Startup objects. (Ready-Bake ArrayLists: 

gets user input, Startups know their Code). It knows one for the 

plays until all Start- name, location, and how to accept user StartupBust and 
ups are dead. how to check a user command-line one for each 


5 Objects: 


guess for a match. input, and make of the three 


Startup locations. Startup obj acts 


Stà 
StartupBust ST GameHelper 
Startup 
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detailed structure of the game 


Who does what in the StartupBust game 


(and when) 
StartupBust The main() method 
The game instantiates in the StartupBust 
1) class. class instantiates the 


StartupBust object that 
does all the game stuff. 


StartupBust 
object 


instantiates 


a saad The StartupBust (game) 

object instantiates an 
2) instance of GameHelper, 
the object that will help 

StartupBust the game do its work. 


object 


The StartupBust object 
instantiates an ArrayList 
that will hold the three 


GameHelper Startup objects. 


object 


StartupBust 
object 


ArrayList object (to 
hold Startup objects) 
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The StartupBust object 
creates three Startup 
objects (and puts them in 
the ArrayList). 


GameHelper 


StartupBust 
object ArrayList object to 


hold Startup objects Startup 


objects 


The StartupBust object gives each of 

the Startup objects a location (which the 
StartupBust got from the helper object) like 
“A2,""B2," etc. Each Startup object puts his 
own three location cells in an ArrayList. 


The StartupBust object asks the 
helper object for a location fora 
Startup (does this three times, one 
for each Startup). 


ArrayList object 
(to hold Startup 
cell locations) 


StartupBust 
object 
ArrayList 
ArrayList object to object 
hold Startup objects sie 
The StartupBust object asks the The StartupBust object loops through the list of 


Startups, and asks each one to check the user guess 
for a match. Each Startup checks its locations 
ArrayList and returns a result (“hit," “miss,” etc.). 


helper object for a user guess (the 
helper prompts the user and gets input 
from the command line). 


5 
er gues 
ot 3S 


rere wis 


GameHelper ArrayList object 


(to hold Startup 
cell locations) 


StartupBust 
object 


ArrayList 


And so the game continues...getting 
object 


user input, asking each Startup to ArrayList object to 
check for a match, and continuing hold Startup objects 
until all Startups are dead 


Startup 
objects 
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the StartupBust class (the game) 


prep code p code 
StartupBust 


GameHelper helper 
ArrayList startups 
int numOfGuesses 


setUpGame() 


startPlaying() 


checkUserGuess() 


finishGame() 


Variable 


Declarations 


Method 


Declarations 


Method 


Implementations 
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Prep code for the real StartupBust class 


The StartupBust class has three main jobs: set up the game, play the game until 

the Startups are dead, and end the game. Although we could map those three jobs 
directly into three methods, we split the middle job (play the game) into wo methods 
to keep the granularity smaller. Smaller methods (meaning smaller chunks of func- 
tionality) help us test, debug, and modify the code more easily. 


DECLARE and instantiate the GameHelper instance variable, named helper. 
DECLARE and instantiate an ArrayList to hold the list of Startups (initially three) Call it startups. 


DECLARE an int variable to hold the number of user guesses (so that we can give the user a 
score at the end of the game). Name it numOfGuesses and set it to 0. 


DECLARE a setUpGame() method to create and initialize the Startup objects with names and 
locations. Display brief instructions to the user. 


DECLARE a startPlaying() method that asks the player for guesses and calls the 
checkUserGuess() method until all the Startup objects are removed from play. 


DECLARE a checkUserGuess() method that loops through all remaining Startup objects and 
calls each Startup object's checkYourself() method. 


DECLARE a finishGame() method that prints a message about the user's performance, based 
on how many guesses it took to sink all of the Startup objects. 


METHOD: void setUpGame() 
// make three Startup objects and name them 
CREATE three Startup objects. 
SET a name for each Startup. 
ADD the Startups to startups (the ArrayList). 
REPEAT with each of the Startup objects in the startups List: 


CALL the placeStartup() method on the helper object, to get a randomly-selected 
location for this Startup (three cells, vertically or horizontally aligned, on a 7 X 7 grid). 


SET the location for each Startup based on the result of the placeStartup() call. 
END REPEAT 
END METHOD 


get to know the Java API 
prep code p code 


Method implementations continued: 


METHOD.: void startPlaying() 
REPEAT while any Startups exist. 
GET user input by calling the helper getUserlnput() method. 


EVALUATE the user's guess by checkUserGuess() method. 
END REPEAT 


END METHOD 


METHOD: void checkUserGuess (String userGuess) 
// find out if there’s a hit (and kill) on any Startup 
INCREMENT the number of user guesses in the numOfGuesses variable. 
SET the local result variable (a String) to “miss”, assuming that the user's guess will be a miss. 
REPEAT with each of the Startup objects in the startups List. 
EVALUATE the user's guess by calling the Startup object's check Yourself() method. 
SET the result variable to “hit” or “kill” if appropriate. 


IF the result is “kill”, REMOVE the Startup from the startups List. 
END REPEAT 


DISPLAY the result value to the user. 
END METHOD 


METHOD.: void finishGame() 
DISPLAY a generic “game over” message, then: 
IF number of user guesses is small, 


DISPLAY a congratulations message. 


ELSE 
DISPLAY an insulting one. 
END IF 
END METHOD 
; —— Yours to solve. 
iad your pencil 
aN 


How should we go from prep code to the methods. And which method do you test 
final code? First we start with test code, and and write first? See if you can work out some 
then test and build up our methods bit by prep code for a set of tests. Prep code or 

bit. We won't keep showing you test code even bullet points are good enough for this 


in this book, so now it’s up to you to think exercise, but if you want to try to write the 
about what you'd need to know to test these real test code (in Java), knock yourself out. 
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the StartupBust code (the game) 


prep code test code 


import java.util.ArrayList; 


public class StartupBust { 
private GameHelper helper 


private int numOfGuesses = 0; 


private void setUpGame() { 


// first make some Startups and give them locations 


Startup one new Startup (); 
one.setName ("poniez") ; 
Startup two new Startup(); 
two.setName ("hacqi"); 
Startup three 
three.setName ("Cabista") ; 
startups .add (one); 
startups .add (two); 
startups .add (three); 


System.out.println ("Your goal is to sink three Startups."); 
hacqi, 
System.out.println("Try to sink them all in the fewest number of guesses"); 


System.out.printlin("poniez, 


for (Startup startup 


} // close for loop 
} // close setUpGame method 


private void startPlaying() 
while (!startups.isEmpty () ) 
String userGuess 
checkUserGuess (userGuess) ; 
} // close while 
finishGame () ; 


} // close startPlaying method 


new GameHelper (); 
private ArrayList<Startup> startups 


new Startup (); 


startups) 
ArrayList<String> newLocation = helper.placeStartup (3) ; 
startup.setLocationCells (newLocation) ; 


helper.getUserInput ( 


ohare your pencil 


Annotate the code 
yourself! 


new ArrayList<Startup>(); 


Match the annotations 
at the bottom of each 
page with the numbers 

in the code. Write the 
number in the slot in front 
of the corresponding 
annotation. 


© 


You'll use each annotation 
just once, and you'll need 
all of the annotations. 


cabista"); 


i © 
© 


© 


{ 
1 @ 
"Enter a guess"); 


_ Ask the helper for a Startup location 


paea a, ee = Get user input LR epeat with each Startup in the list 
—~ khe variables We ~~ Call 4 i 
__ Print brief to give iaa method on this Startup all our own CheckUser-Guess wethed 
ocation ou just 

~~ instructions ‘or rom the helper 7 j got 

user a7 
ts, give ‘em _As long as the Startup 

Make three ie id be ae — list is NOT empty 


~— Call our own finishGame method 
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prep code test code 


private void checkUserGuess (String userGuess) { Whatever you do, 
numOfGuesses++; 1) DON’T turn the 
String result = "miss"; (2) page! 
for (Startup startupToTest : startups) { ©) Not until you’ve 
result = startupToTest .checkYourself (userGuess); finished this 
exercise. 
if (result.equals("hit")) { 
break; F 2 
} (45) Our version is on 
if (result.equals("kill")) { the next page. 
startups .remove (startupToTest) ; = 
break; 


} 


} // close for 


System.out.printin (result); (i?) 
} // close method 


private void finishGame() { 
System.out.println("All Startups are dead! Your stock is now worthless"); 


if (numOfGuesses <= 18) { 
System.out.printlin("It only took you " + numOfGuesses + " guesses."); 
System.out.printin("You got out before your options sank."); 

} else { 
System.out.printlin("Took you long enough. " + numOfGuesses + " guesses."); 


System.out.printin("Fish are dancing with your options"); 


} 
} // close method 


public static void main(String[] args) { 
StartupBust game = new StartupBust (); 
game .setUpGame () ; 


game.startPlaying(); @1) 
} // close method 


Repeat with all Startups in the list Bia 
This one’s dead, s tak Š — Print a message tellin the resu or 
Startups list Phen get a ine ie user how they did in A € game the user aye a 
__ le e Jame objet 
Increment the number of guesses the user has mane l to set up the game 
— Assume it’s a ‘miss, unless told otherwise 
Tell th to check the user guess, 
Get out of the loo ON the game objeed Ask the Startup to che 
early, et ` Jame Play loop (Peet to start the » — locking for a hit Cor kill) 
i fo paia in testing input. a, 1 oot keeps asking foy- iia ooking 


_— Create the game object 
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the StartupBust code (the game) 


prep code test code 


import java.util.ArrayList; 
witialize 
Declare and nÀ need: 


bles WE 


public class StartupBust { {he varia 


private GameHelper helper = new GameHelper (); 
private ArrayList<Startup> startups = new ArrayList<Startup>(); 
private int numOfGuesses = 0; 


private void setUpGame() { 
// first make some Startups and give them locations 
Startup one = new Startup(); 
one.setName ("poniez") ; 


Startup two = new Startup(); 


two.setName ("hacqi") ; Make three Startup objects, 
stk. em 
Startup three = new Startup(); ive ‘em names, ân 
" x " m the AvvayList- 
three.setName ("cabista") ; 
startups.add(one) ; 
startups .add (two); Pant brief 
startups.add(three) ; instructions for user. 
System.out.printin("Your goal is to sink three Startups."); 


System.out.printin("poniez, hacqi, cabista"); 
System.out.println("Try to sink them all in the fewest number of guesses"); 


2 Repeat with each Startup in the list- ae 
K j ‘Ol 
for (Startup startup : startups) { Ae e ter f ra 


ArrayList<String> newLocation = helper.placeStartup (3) i ArrayList of Strings). 


startup.setLocationCells (newLocation) ; € Call the seller 4 
} // close for loop ra to aie tee 
} // close setUpGame method just 9o from the helper. ton You 


ee ie Tat 
private void startPlaying O { As long as the Startup list is KOT ea ' means NO its 
while (!startups.isEmpty()) { & the same as (startups.isEmpty ae 


String userGuess = helper.getUserInput ("Enter a guess"); e Get user input. 


checkUserGuess (userGuess) ; 
( ); a Call our own ch k 
} // close while et UserGuess method 


finishGame(); ¢—— Call our own finishGame method. 
} // close startPlaying method 
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prep code test code 


rivate void checkUserGuess (String userGuess) of{ 
Í PRN the number of guesses the user has made 


numOfGuesses++; l 
Assume it’s a ‘miss’, unless told otherwise 


String result = "miss"; €— 


. in the list 
for (Startup startupToTest : startups) { <— Repeat with all Startups m 


result = startupToTest.checkYourself (userGuess) ; ę— Ask the Startup to check na 
guess, looking for a hit Cor ki 


if (result.equals("hit")) { Get out of the loo 
early, i 
break; e in testing the reel ly, no point 
} 
if (result.equals("kill")) { Thione 
nes dead, so take it out of 4 
startups .remove (startupToTest); e : out ot the 
en Startups list then get out of the loop 


} 
} // close for 


System.out.println (result) ;—— Print the result for the user 
} // close method 


Print a message telling the 
user how they did in The Game 


private void finishGame() { 
System.out.println("All Startups are dead! Your stock is now worthless"); 
if (numOfGuesses <= 18) { 


System.out.printin("It only took you " + numOfGuesses + " guesses."); 


System.out.printin("You got out before your options sank."); 
} else { 
System.out.printin("Took you long enough. " + numOfGuesses + " guesses."); 


System.out.printin("Fish are dancing with your options"); 


} 
} // close method 


public static void main(String[] args) { c 
StartupBust game = new StartupBust (); — reate the Jame ob; 


bject 
game .setUpGame () ; a fell the Jame a 
game.startPlaying(); C Tell the game object set up the Jame 
} // close method Jame play loop (Doers te start the mån 
input and checkin i or ae 
SS 
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the Startup code 


prep code test code 


The final version of the 
Startup class 
import java.util.ArrayList; 


Mes iables: 
public class Startup { Startup s instante: varia 
private ArrayList<String> locationCells; - an ArrayList of cell locations 
private String name; — the Startup’s name 


hod that 
public void setLocationCells (ArrayList<String> loc) { «—— A setter neve 


fs ; updates the Startup’s 
ocationCells = loc; siete ani 
location provided by the 
Gamettelper placeStartup( 
public void setName (String n) { = Your basie setter method method.) 
name = ni | 
i The ArrayList indexO£( ) method in 
action! id the user guess is one he 
entries in the ArrayList, indexO4( ) 
public String checkYourself (String userInput) { will return its ArrayList location. | 
String result = "miss"; e m ae ‘i 


int index = locationCells.indexOf (userInput) ; L— 
if (index >= 0) { 


Using ArvayList’s removel) method to delete an entry. 
locationCells.remove (index) ; e 


if (locationCells.isEmpty()) { C Using the isEmpty() method to see if all 


result = "kill"; of the locations have been guessed 
System.out.printin("Ouch! You sunk " + name + " 2 CO" )3 

} else { So 
result = "hit"; 


Tell the user wh 
e 
} // end if i Startup has been sunk. 


} // end outer if 
return result; 
} // end method Return: ‘miss’ oF ‘hit? or ‘Gi 


} // close class 
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Super powerful Boolean expressions 


So far, when we've used Boolean expressions for our loops or if 
tests, they've been pretty simple. We will be using more powerful 
boolean expressions in some of the Ready-Bake Code you're about to 
see, and even though we know you wouldn't peek, we thought this 
would be a good time to discuss how to energize your expressions. 


“And” and “Or” Operators (&&, ||) 


Let's say you're writing a chooseCamera( ) method, with lots of rules 
about which camera to select. Maybe you can choose cameras 
ranging from $50 to $1000, but in some cases you want to limit the 
price range more precisely. You want to say something like: 


“If the price range is between $300 and $400, then choose X.” 


if (price >= 300 && price < 400) { 
camera = "X"; 


} 


Let’s say that of the ten camera brands available, you have some logic 
that applies to only a few of the list: 


if (brand.equals("A") || brand.equals("B")) { 
// do stuff for only brand A or brand B 
} 


Boolean expressions can get really big and complicated: 


if ((zoomType.equals ("optical") && 
(zoomDegree >= 3 && zoomDegree <= 8) ) || 
(zoomType.equals ("digital") && 
(zoomDegree >= 5 && zoomDegree <= 12))) { 
// do appropriate zoom stuff 
} 


If you want to get really technical, you might wonder about the 
precedence of these operators. Instead of becoming an expert 
in the arcane world of precedence, we recommend that you use 
parentheses to make your code clear. 
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Not equals (!= and !) 
Let’s say that you have a logic like “of the ten available 
camera models, a certain thing is true for all but one.” 


if (model != 2000) { 
// do non-model 2000 stuff 


= 


or for comparing objects like strings... 


if (!brand.equals("X")) { 
// do non-brand X stuff 
} 


Short-Circuit Operators ( && , ||) 


The operators we've looked at so far, && and ||, are 
known as short-circuit operators. In the case of &&, 
the expression will be true only if both sides of the && 
are true. So if the JVM sees that the left side of a && 
expression is false, it stops right there! Doesn't even 
bother to look at the right side. 


Similarly, with ||, the expression will be true if either side is 
true, so if the JVM sees that the left side is true, it declares 
the entire statement to be true and doesn't bother to 
check the right side. 


Why is this great? Let's say that you have a reference 
variable and you're not sure whether it’s been assigned 
to an object. If you try to call a method using this null 
reference variable (i.e., no object has been assigned), 
you'll get a NullPointerException. So, try this: 


if (refVar != null && 
refVar.isValidType()) { 
// do ‘got a valid type’ stuff 
} 


Non-Short-Circuit Operators ( & , | ) 


When used in boolean expressions, the & and | operators 
act like their && and || counterparts, except that 

they force the JVM to always check both sides of the 
expression. Typically, & and | are used in another context, 
for manipulating bits. 
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Ready-Bake: GameHelper 


This is the helper class for the game. Besides the user input method (that 
prompts the user and reads input from the command line), the helper’s Big 
Service is to create the cell locations for the Startups. We tried to keep it fairly 
small so you wouldn't have to type so much. And remember, you won't be able 
to compile the StartupBust game class until you have this class. 


import java.util.*; 


public class GameHelper { 
private static final String ALPHABET = "abcdefg"; 
private static final int GRID LENGTH = 7; 
private static final int GRID SIZE = 49; 
private static final int MAX ATTEMPTS = 200; 
static final int HORIZONTAL INCREMENT = 1; // A better way to represent these two 
static final int VERTICAL INCREMENT = GRID LENGTH; // things is an enum (s Appendix B) 


Fl 
`~ 


private final int[] grid = new int[GRID SIZI Note: For extra credit, you might 
private final Random random = new Random (); ty “un—Commenting” the 
private int startupCount = 0; System wut: println’ s, j i Le wattk 

' : , it workl These print statements will 
public String getUserInput (String prompt) { wane “cheat” by giving you the 


System-out-print (prompt + T: ")y location of the Startups but it will 
Scanner scanner = new Scanner (System.in); help you test it ) 


return scanner.nextLine() .toLowerCase(); 
} //end getUserInput 


public ArrayList<String> placeStartup(int startupSize) { 
// holds index to grid (0 - 48) 


int[] startupCoords = new int[startupSize]; // current candidate co-ordinates 
int attempts = 0; // current attempts counter 
boolean success = false; // flag = found a good location? 
startupCount++; // nth Startup to place 
int increment = getIncrement (); // alternate vert & horiz alignment 
while (!success & attempts++ < MAX_ATTEMPTS) { // main search loop 
int location = random.nextInt (GRID SIZE); // get random starting point 
for (int i = 0; i < startupCoords.length; i++) { // create array of proposed coords 
startupCoords[i] = location; // put current location in array 
location += increment; // calculate the next location 
} 
// System.out.printin("Trying: " + Arrays.toString(startupCoords) ); 
if (startupFits(startupCoords, increment)) { // startup fits on the grid? 
success = coordsAvailable(startupCoords) ; // ...and locations aren't taken? 
} // end loop 
} // end while 
savePositionToGrid(startupCoords) ; // coords passed checks, save 
ArrayList<String> alphaCells = convertCoordsToAlphaFormat (startupCoords) ; 
+ " $ " 
// System.out.println("Placed at: "+ alphaCells); statement that 
return alphaCells; a This is the sta thè 
} //end placeStartup tells you exactly where 


Startup | is lotated. 
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aa Ready-Bake 
=i Cade GameHelper class code continued... 


private boolean startupFits(int[] startupCoords, int increment) { 
int finalLocation = startupCoords[startupCoords.length - 1]; 
if (increment == HORIZONTAL INCREMENT) { 
// check end is on same row as start 
return calcRowFromIndex(startupCoords[0]) == calcRowFromIndex (finalLocation) ; 
} else { 


// check end isn't off the bottom 


eal 
~e 


return finalLocation < GRID SIZ 


} 
} //end startupFits 


private boolean coordsAvailable(int[] startupCoords) { 
for (int coord : startupCoords) { // check all potential positions 
if (grid[coord] != 0) { // this position already taken 
// System.out.println("position: " + coord + " already taken."); 
return false; // NO success 
} 
} 
return true; // there were no clashes, yay! 
} //end coordsAvailable 
private void savePositionToGrid(int[] startupCoords) { 
for (int index : startupCoords) { 
grid[index] = 1; // mark grid position as 'used' 


} 

} //end savePositionToGrid 

private ArrayList<String> convertCoordsToAlphaFormat (int[] startupCoords) { 
ArrayList<String> alphaCells = new ArrayList<String>(); 


for (int index : startupCoords) { // for each grid coordinate 
String alphaCoords = getAlphaCoordsFromIndex (index); // turn it into an "a0" style 
alphaCells.add(alphaCoords) ; // add to a list 

} 

return alphaCells; // return the "a0"-style coords 


} // end convertCoordsToAlphaFormat 

private String getAlphaCoordsFromIndex (int index) { 
int row = calcRowFromIndex (index) ; // get row value 
int column = index % GRID_LENGTH; // get numeric column value 
String letter = ALPHABET.substring(column, column + 1); // convert to letter 
return letter + row; 

} // end getAlphaCoordsFromIndex 

private int calcRowFromIndex(int index) { 
return index / GRID_LENGTH; 

} // end calcRowFromIndex 


private int getIncrement() { 
if (startupCount % 2 == 0) { // if EVEN Startup 
return HORIZONTAL INCREMENT; // place horizontally 
} else { // else ODD 
return VERTICAL_INCREMENT; // place vertically 


} 
} //end getIncrement 
} //end class 


This code, and a basit test, is available in the GitHub 
repo, https://oreil.ly/hfJava_3e_examples 
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API packages 


Using the Library (the Java API) 


You made it all the way through the StartupBust game, thanks 
to the help of ArrayList. And now, as promised, it’s time to 
learn how to fool around in the Java library. 


In the Java API, classes 
are grouped into packages. 


To use a class in the API, you 
have to know which package 
the class is in. 


Every class in the Java library belongs to a package. The 
package has a name, like javax.Swing (a package 
that holds some of the Swing GUI classes you'll learn 
about soon). ArrayList is in the package called java. 
util, which surprise surprise, holds a pile of utility classes. 
You'll learn a lot more about packages in Appendix 

B, including how to put your own classes into your own 
packages. For now, though, we’re just looking to use some 
of the classes that come with Java. 


Using a class from the API, in your own code, is simple. 
You just treat the class as though you wrote it yourself... 
as though you compiled it, and there it sits, waiting for 
you to use it. With one big difference: somewhere in your 
code you have to indicate the full name of the library 
class you want to use, and that means package name + 
class name. 


Even if you didn’t know it, you’ve already been using 
classes from a package. System (System.out.println), 
String, and Math (Math.random()) all belong to the 
java.lang package. 
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You have to know the full name* of the 
class you want to use in your code. 


ArrayList is not the full name of ArrayList, just as Kathy isn’t a full name 
(unless it’s like Madonna or Cher, but we won’t go there). The full name of 
ArrayList is actually: 


java.util.ArrayList 
oe Nean S —_~_— 


Package name elass name 


You have to tell Java which ArrayList you want to 
use. You have two options: 


IMPORT 
O Put an import statement at the top of your source code file: 


import java.util.ArrayList; 
public class MyClass {... } 


OR 
TYPE 
©} Type the full name everywhere in your code. Each time you use it. 


Everywhere you use it. 


When you declare and/or instantiate it: 
java.util .ArrayList<Dog> list = new java.util .ArrayList<Dog>() ; 


When you use it as an argument type: 
public void go(Jjava.util.ArrayList<Dog> list) { } 


When you use it as a return type: 


public java.util .ArrayList<Dog> foo() {...} 


*Unless the class is in the java.lang package. 
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when arrays aren’t enough 
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there, are no 


Dumb Questions 


: Why does there have to 
be a full name? Is that the only 
purpose of a package? 


A: Packages are important for 
three main reasons. First, they 
help the overall organization of a 
project or library. Rather than just 
having one horrendously large 
pile of classes, they're all grouped 
into packages for specific kinds 
of functionality (like GUI or data 
structures or database stuff, etc.). 


Second, packages give you a name- 
scoping, to help prevent collisions 
if you and 12 other programmers 

in your company all decide to 

make a class with the same name. 
If you have a class named Set and 
someone else (including the Java 
API) has a class named Set, you 
need some way to tell the JVM 
which Set class you're trying to use. 


Third, packages provide a level of 
security, because you can restrict 
the code you write so that only 
other classes in the same package 
can access it. The details are in 
Appendix B. 


Q: OK, back to the name 
collision thing. How does a full 
name really help? What’s to 
prevent two people from giving a 
class the same package name? 


A: Java has a naming 


convention that usually prevents 
this from happening, as long as 
developers adhere to it. 
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BULLET POINTS 
ArrayList is a class in the Java API. 


To put something into an ArrayList, use add(). 


To remove something from an ArrayList use 
remove(). 


To find out where something is (and if it is) in an 
ArrayList, use indexOf(). 


To find out if an ArrayList is empty, use isEmpty(). 


To get the size (number of elements) in an ArrayList, 
use the size() method. 


To get the length (number of elements) in a regular 
old array, remember, you use the length variable. 


An ArrayList resizes dynamically to whatever size 
is needed. It grows when objects are added, and it 
shrinks when objects are removed. 


You declare the type of the array using a type 
parameter, which is a type name in angle brackets. 
Example: ArrayList<Button> means the ArrayList 

will be able to hold only objects of type Button (or 
subclasses of Button as you'll learn in the next couple 
of chapters). 


Although an ArrayList holds objects and not primi- 
tives, the compiler will automatically “wrap” (and “un- 
wrap” when you take it out) a primitive into an Object 
and place that object in the ArrayList instead of the 
primitive. (More on this feature later in the book.) 


Classes are grouped into packages. 


A class has a full name, which is a combination of the 
package name and the class name. Class ArrayList is 
really java.util.ArrayList. 


To use a class in a package other than java.lang, you 
must tell Java the full name of the class. 


You can either use an import statement at the top of 
your source code, or you can type the full name every 
place you use the class in your code. 


there are_no z 
Dumb Questions 


: Does import make my class 
bigger? Does it actually compile the 
imported class or package into my 
code? 


A: Perhaps you're a C program- 
mer? An import is not the same as an 
include. So the answer is no and no. 
Repeat after me:“an import statement 
saves you from typing.’ That’s really it. 
You don't have to worry about your 
code becoming bloated, or slower, from 
too many imports. An import is simply 
the way you give Java the full name ofa 
class. 


+ OK, how come I never had to 
import the String class? Or System? 


A: Remember, you get the java.lang 
package sort of “pre-imported” for free. 
Because the classes in java.lang are so 
fundamental, you don’t have to use the 
full name. There is only one java.lang. 
String class and one java.lang.System 
class, and Java darn well knows where 
to find them. 


+ Do Ihave to put my own classes 
into packages? How do I do that? Can 
I do that? 


A: In the real world (which you 
should try to avoid), yes, you will want 
to put your classes into packages. We'll 
get into that in detail in Appendix B. For 
now, we won't put our code examples in 
a package.* 


*But when you look at the code in the repo 


(hitps://oreul. ly/hffava_3e_examples), you'll see 


we put the classes into packages. 
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One more time, in the unlikely 
event that you don’t already 
have this down: 
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“Good to know there’s an ArrayList in the java. 
util package. But by myself, how would I have 
figured that out?” 


- Julia, 31, hand model 


How to discover the API 


Two things you want to know: 


What features are available in the 
library? (Which classes?) 


6 How do you use these features? 
(Once you find a class, how do 
you know what it can do?) 


T Browse a book 


oO Use the HTML API docs 


MODULE PACKAGE CLASS USE TREE PREVIEW NEW DEPRECATED INDEX HELP 


Java’ Platform, Standard Edition & Java Development Kit 
Version 17 API Specification 
This document is divided into two sections: 
Java SE 
The Java Platform, Standard Edition (Java SE) APIs define the core Java platform 
JDK 
The Java Development Kit (JDK) APIs are specific to the JDK and will not necessaz 


a sve se | sox | other menues 


in a Nutshell 


A DESKTOP QUICK REFERENCE Module Description 
java.base Defines the foundational APIs of the Java SE Platform. 
Benjamin J. Evans & David Flanagan java.compiler Defines the Language Model, Annotation Processing, a 
java.datatransfer Defines the API for transferring data between and witk 


https://docs.oracle.com/en/java/javase/17/docs/api/index.html 
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GD Browse a book 


Java. 


in a Nutshell 


Flipping through a reference 
book is a good way to find out 
what’s in the Java library. You can 
easily stumble on to a package 

or class that looks useful just by 
browsing pages. 
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O'REILLY 


4 8. Working with Java Collections 


12h 3m remaining 


The List Interface 


A List is an ordered collection of objects. Each element of a list has a position in 
the list, and the List interface defines methods to query or set the element at a 
particular position, or index. In this respect, a List is like an array whose size 
changes as needed to accommodate the number of elements it contains. Unlike 


sets, lists allow duplicate elements. 


In addition to its index-based get() and set() methods, the List interface 
defines methods to add or remove an element at a particular index and also de- 
fines methods to return the index of the first or last occurrence of a particular 
value in the list. The add() and remove() methods inherited from 
Collection are defined to append to the list and to remove the first occurrence 
of the specified value from the list. The inherited addA11() appends all elements 
in the specified collection to the end of the list, and another version inserts the el- 
ements at a specified index. The retainAll() and removeAll() methods be- 
have as they do for any Collection, retaining or removing multiple occur- 


rences of the same value, if needed. 


The List interface does not define methods that operate on a range of list in- 
dexes. Instead, it defines a single subList() method that returns a List object 
that represents just the specified range of the original list. The sublist is backed by 
the parent list, and any changes made to the sublist are immediately visible in the 
parent list. Examples of subList() and the other basic List manipulation 


methods are shown here: 


// Create lists to work with 

List<String> 1 = new ArrayList<String>(Arrays.asList(args) ); 
List<String> words = Arrays.asList("hello", "world"); 
List<String> words2 = List.of("hello", "“world"); 


#% 2 
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2) Use the HTML API docs 


Java comes with a fabulous set of online docs called, strangely, the Java API. You (or your IDE) can also 
download the docs to have on your hard drive just in case your internet connection fails at the Worst Possible 
Moment. 


The API docs are the best reference for getting more details about what’s in a package, and what the classes 
and interfaces in the package provide (e.g., in terms of methods and functionality). 


The docs look different depending upon the version of Java you're using 
Make sure you're looking at the docs for your version of Java! 


Java 8 and earlier 


‘ wis 
sion: 
A «70 ) ava ve t 
https://docs.oracle.com/javase/8/docs/api/index.html `< Java 8 Sl 
S 
™ Platt Java™ Platform 

PACKAGE CLASS USE TREE DEPRECATED INDEX HELP Standard Ed. 8 

All Classes All Profiles PREV NEXT FRAMES NO FRAMES 

Packages ie 
Seroll through the pack— Java™ Platform, Standard Edition 8 

applet A i 
ages and select one (eliek ae API Specification 
t re. . l java.awt.color 
K viet the l ist java.awt.datatransfer This document is the API specification for the Java™ Platform, Standard Edition. 
In the l java.awt.dnd S 
| ower rame to java.awt.event See: Description 

only classes from that Faucwsses | 
Package. j Profiles 

AbstractAction 

AbstractAnnotationValueVisitor6 

AbstractAnnotationValtieVisitor? : ae 

AbstractAnnotationValueVisitor8 

AbstractButton 


AbstractCellEditor 


AbstractChronology | Packages | 
classes AbstractCollection 


h the : 
Nal . AbstractColorChooserPanel 
Corel thro 2 (eliek vo) AbstractDocument packege, Descnipuon 
eet one 3 AbstractDocument.AttributeContext java.applet Provides the classes necessary to create an 
and S th ss AbstractDocument.Content applet and the classes an applet uses to 
noose b er AbstractDocument.ElementEdit communicate with its applet context. 
m N Lg AbstractElementVisitor6 
A RN the AbstractElementVisitor7 java.awt Contains all of the classes for creating user 
wi AbstractElementVisitor8 interfaces and for painting graphics and 
f ame: AbstractExecutorService images. 
v AbstractinterruptibleChannel 
AbstractLayoutCache java.awt.color Provides classes for color spaces. 
AbstractLayoutCache.NodeDimensions 
AbstractList Java.awt.datatransfer Provides interfaces and classes for 
AbstractListModel transferring data between and within 
AbstractMap applications. 
AbstractMap.SimpleEntry 
AbstractMap.SimplelmmutableEntry java.awt.dnd Drag and Drop is a direct manipulation 
AbstractMarshallerimp! aesture found in manv Graphical User 
You can navigate these docs: The main panel will s i 
g agat if pa ‘ how you the details of whatever oure look— 
- Top down: find a package you're PAL u ms ect a package, it will give Summary intormation 
. . . . U H 
interested in from the list in the at package and a list of the élasses and interfaces. 
top left and drill down. If you select a elass, it will show you a destription of the elass 
-  Class-first: find the class you want 4nd details of all the methods in the class, what they do, and (om 
to know more about in the list in use them. ’ 


the bottom left, and click it. 


160 chapter 6 


get to know the Java API 


Java 9 and later 


Java 9 introduced the Java Module System, which we’re not going to cover in this book. What you do need 
to know to understand the docs is that the JDK is now split into modules. These modules group together 
related packages. This can make it easier to find the classes that interest you, because they’re grouped by 
function. All of the classes we’ve covered in this book so far are in the java. base module; this contains 


core Java packages like java.lang and java.util. i eco’ 
' s X 
Slightly different URL to Ja? bh p Guth" gye 
the older does Lam ern a 
https://docs.oracle.com/en/java/javase/17/docs/api/index.html (S ; gt" 
Age 
MODULE PACKAGE CLASS USE TREE PREVIEW NEW DEPRECATED INDEX HELP Java SE 17 & JDK 17 
SEARCH: [QR sern o 
Lear 
Java’ Platform, Standard Edition & Java Development Kit SPee: h fo, 
Version 17 API Specification e Cif; a 


This document is divided into two sections: 


Java SE it h i y £ ‘ 
The Java Platform, Standard Edition (Java SE) APIs define the core Java platform for general-purpose computing. a Ch, e. K 5 Ping 
These APIs are in modules whose names start with java. dro ou / S, 
JDK Sugg est “dow, ah 
The Java Development Kit (JDK) APIs are specific to the JDK and will not necessarily be available in all lon, S. 
implementations of the Java SE Platform. These APIs are in modules whose names start with jdk. 
PT vase [o | omer ose | 
Module Description 
java.base Defines the foundational APIs of the Java SE Platform. 
java.compiler Defines the Language Model, Annotation Processing, and Java Compiler APIs. 
java.datatransfer Defines the API for transferring data between and within applications. 
T he Java java.desktop Defines the AWT and Swing user interface toolkits, plus APIs for accessibility, audio, imaging, printing, 
J Loren \S and JavaBeans. 
yla b oxen jaws inetmiımani b Nafinaa aamrinnaa that allaur amanto ta inatmimant nrasmamoe minnine an tha TA 
Y 
now : 
haa umber \sted © 
m whith ae 
of modules: “^ £ Lhe dots: 
t as 
: kere e 
; osl only w rf ko the MODULE: DESCRIPTION | MODULES | PACKAGES | SERVICES SEARCH: |9, Search 
rew 
We anes we g pout Module java.base 
e ava base- \\ care a IUU uM 
% : Gul we module java.base 
an kor 3s well. Defines the foundational APIs of the Java SE Platform. 
\ava-ae Providers: 
3 The JDK implementation of this module provides an implementation of the jrt file system provider to en 
and resource files in a run-time image. The jrt file system can be created by calling 
FileSystems .newFileSystem(URI.create("jrt:/")). 
You can navigate these docs: edule orept 
a java.base 
* Top down: find a module that looks i 
i i i i Tool Guides: 
like it covers the functionality you ieee 
want, see its packages, and drill down since: 
from a package into its classes. when Y rye selected 
; en You Pack: 
+ Search: Use the search in the a module, YX tan OET 
top right to go directly to the see. a list of all | Exports | 
method, class, package, or module - {s packages and â rise ne 
V Y h a java.io Provides for system input and output through data streams, serializati 
you want to read about. ption où W 
destv' Į À s for java.lang Provides classes that are fundamental to the design of the Java progra 
eath package java.lang.annotation Provides library support for the Java programming language annotatic 
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when arrays aren’t enough 


Using the class documentation 


Whichever version of the Java docs you’re using, they all have a similar layout for showing information 
about a specific class. This is where the juicy details are. 


Let’s say you were browsing through the reference book and found a class called ArrayList, in java.util. 
The book tells you a little about it, enough to know that this is indeed what you want to use, but you still 
need to know more about the methods. In the reference book, you'll find the method indexOf). But if all 
you knew is that there is a method called indexOf() that takes an object and returns the index (an int) of 
that object, you still need to know one crucial thing: what happens if the object is not in the ArrayList? 
Looking at the method signature alone won’t tell you how that works. But the API docs will (most of the 
time, anyway). The API docs tell you that the indexOf{) method returns a -1 if the object parameter is 
not in the ArrayList. So now we know we can use it both as a way to check if an object is even in the 
ArrayList, and to get its index at the same time, if the object was there. But without the API docs, we 
might have thought that the indexOf{) method would blow up if the object wasn’t in the ArrayList. 


ee 
Java SE 17 & JDK 17 Make sure j 


OVERVIEW MODULE PACKAGE USE TREE PREVIEW NEW DEPRECATED INDEX HELP 


i ou re 
SUMMARY: NESTEB FIELD | CONSTR | METHOD ookin at he 
d 
= or the Same 
gis ox Constructor Summary no of Java 
\ 

e h oe 
cee Oe Šk podos MEE the Aie asin 
khe ewe NR Ans Constructor Description Is Chan e 

: yt i) Ymg 3 SF ET : rom versio to 
Gaa y Aet N ArrayList() Constructs an empty list with an initial capacity of ten. versio n 
n. 
Bee ArrayList(int initialCapacity) Constructs an empty list with the specified initial capacity. 
“Pal 


ArrayList (Collection<? extends E> c) Constructs a list containing the elements of the specified collection, in the 
order they are returned by the collection's iterator. 


Method Summary 
P| instance Methods | concrete Methods ris is were all tre 
\ 
Modifier and Type Method Descrip sku ìs- You tan 
void add(int index, E element) Inserts t ood h the 
position i stroll throug 
boolean add(E e) Appends i ods Lor a brie 
sot mE c Aiek on 
boolean addAll (int index, Collection<? extends Inserts all « summa rY 


E> c) 


collection i1 
position. ame o 


boolean addALl(Collection<? extends E> c) Appends all ı details: 
collection to \ 
they are retur 
Iterator. 
void clear() Removes all of the elements from this list. 
Object clone() Returns a shallow copy of this ArrayList 
instance. 
boolean contains (Object o) Returns true if this list contains the specified 


element. 
In Chapters 11 and 12, you'll see how 


we use the API docs to figure out how 
to use the Java Libraries. 
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Code Magnets 


Can you reconstruct the code snippets to make a 
working Java program that produces the output 
listed below? NOTE: To do this exercise, you need 
one NEW piece of info—if you look in the API for 
ArrayList, you'll find a second add method that takes 
two arguments: 


printList (a); 


a.remove (2); 


add(int index, Objecto) |public static void printList (ArrayList<String> list) { 


It lets you specify to the 
ArrayList where to put the object you're adding. 


a.add(2, "two"); 


public static void main (String[] args) { 


System. out .print (element + wo Eye 


} 
System.out .printin(); 


if (a.contains ("three") ) { 
a.add ("four"); 


1 
public class ArrayListMagnet { 


if (a.indexOf("four") != 4) { 
a.add(4, "4.2"); 


import java. util.ArrayList; 
J 


ArrayList<String> a = new ArrayLis 


tring> (); 


File Edit Window Help Dance 


% java ArrayListMagnet 


zero one two three 
zero one three four 


a.add (3, three") 
printList (a); 


zero one three four 
zero one three four 


————> Answers on page 165. youarehere> 163 


puzzle: crossword 


JavaCress 


How does this crossword puzzle help you learn 14 
Java? Well, all of the words are Java related 


(except one red herring). 


Hint: When in doubt, remember ArrayList. 


Across 

1. I can't behave 

6. Or, in the courtroom 
7. Where it’s at baby 

9. A fork’s origin 

12. Grow an ArrayList 
13. Wholly massive 

14. Value copy 

16. Not an object 

17. An array on steroids 
19. Extent 


21. 19's counterpart 


22. Spanish geek snacks (Note: This has 15 


nothing to do with Java.) 
23. For lazy fingers 
24. Where packages roam 


More Hints: 


~~ e Burjew seH “8h 
qsrAeuy YUIYL “OL 
BANIWHd “OL 8 Y 
yspAeuy July E 
E2|QEPLUDAO SLYM ‘7 
umoq 
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11 


|20 27 


22 


23 


24 


Down 


2. Where the Java action is 


3. Addressable unit 


4. 2nd smallest 


5. Fractional default 


8. Library’s grandest 


10. Must be low density 


11. He's in there somewhere 


. Asif 


16. dearth method 


18. What shopping and arrays have in common 


20. Library acronym 


21. What goes around 


ssazijadde ysiueds—ener }noqe JON ‘ZZ 
quayxa sAeuy “LZ 

SAMI UOWUWOD ‘91 

ysrpAeuy YUIYL `Z 

SABLA g “1 

ssoly 


————> Answers on page 166. 
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Exercise Solutions import java.util.ArrayList; 


public class ArrayListMagnet { 
public static void main(String[] args) { 
ArrayList<String> a = new ArrayList<String>() ; 


.add (0, 
% java ArrayListMagnet 
zero one two three 


"zero"); 
a.add(1, "one"); 
a.add(2, "two"); 


zero one three four 
zero one three four 4. a.add(3, "three"); 


zero one three four : printList (a); 


if (a.contains("three")) { 
a.add ("four"); 


} 
Code Magnets a.remove (2); 
(from page 163) printList (a); 
if (a.indexOf ("four") != 4) { 
a.add(4, "4.2"); 
} 


printList (a); 


if (a.contains("two")) { 
a.add("2.2"); 

} 

printList (a); 


public static void printList (ArrayList<String> list) { 
for (String element : list) { 
System. out.print (element + " "); 
} 
System.out.printin(); 
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JavaCress |” nD 
(from page 164) B p o i F eL Iri Te 
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Write your OWN set of clues! Look at each word, and try to 
write your own clues. Try making them easier, or harder, or 


Ge sharpen your pencil 
Saal 


Across more technical than the ones we have. 
Ts 

6. Down 
7. 2. 

9. 3. 

12; 4. 

13. 5; 

14. 8. 

16. 10 

17. 11 

19. 15 

21. 16 

22. 18. 

23. 20. 

24. 21 
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7 inheritance and polymorphism 


We were underpaid, 


Better Livi ng in overworked coders ‘till we 


tried the Polymorphism Plan. But 


oO bjectvi | le thanks to the Plan, our future is 


bright. Yours can be too! 


Plan your programs with the future in mind. If there were a way to write 
Java code such that you could take more vacations, how much would it be worth to you? What 
if you could write code that someone else could extend, easily? And if you could write code 
that was flexible, for those pesky last-minute spec changes, would that be something you'd 

be interested in? Then this is your lucky day. For just three easy payments of 60 minutes time, 
you can have all this. When you get on the Polymorphism Plan, you'll learn the 5 steps to bet- 
ter class design, the 3 tricks to polymorphism, the 8 ways to make flexible code, and if you act 
now—a bonus lesson on the 4 tips for exploiting inheritance. Don’t delay, an offer this good 
will give you the design freedom and programming flexibility you deserve. It’s quick, it’s easy, 


and it’s available now. Start today, and we'll throw in an extra level of abstraction! 


this is a new chapter 167 


the power of inheritance 


Chair Wars Revisited... 


Remember way back in Chapter 2, when Laura (pro- 
cedural programmer) and Brad (OO developer) were 
vying for the Aeron chair? Let’s look at a few pieces of 
that story to review the basics of inheritance. 


LAURA: You’ve got duplicated code! The rotate procedure is in 
all four Shape things. It’s a stupid design. You have to maintain 
four different rotate “methods.” How can that ever be good? 


BRAD: Oh, I guess you didn’t see the final design. Let me show 
you how OO inheritance works, Laura. 


I looked at what all four 
rotate() rotate() rotate() rotate() clas ges have in common. 
playSound() playSound() playSound() playSound() 4 
They’re Shapes, and they all rotate and 
playSound. Sol abstracted out the rotate() 
common features and put them into a playSound() 3) 
new class called Shape. — Then | linked the other 
four shape classes to 
superclass | rise) the sa sian class 
playSound() . : f 7 
in a relationship called 


inheritance. 
You can read this as “Square inherits from Shape”, 


“Circle inherits from Shape” and so on. | removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 


subclasses 


The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 
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What about the Amoeba rotate()? 


LAURA: Wasn’t that the whole problem here—that the Amoeba shape had a 
completely different rotate and playSound procedure? 


How can Amoeba do something different if it inherits its functionality 
from the Shape class? 


BRAD: That’s the last step. The Amoeba class overrides any 
methods of the Shape class that need specific amoeba behavior. Then 


at runtime, the JVM knows exactly which rotate() method to run when 
someone tells the Amoeba to rotate. 


superclass 
(more abstract) 


rotate() 


playSound() I made the Amoeba class override the 
rotate() and playSound() methods 

of the superclass Shape. Overriding 
just means that a subelass redefines 
one of its inherited methods when 


it needs to change or extend the 
behavior of that method. 


subclasses 
(more specific) 


Ners (Coe) Cine 


rotate() 
[| amoeba-specific | 
Il rotate code 


Overriding methods 
a i 


playSound() 
/| amoeba-specific 
II sound code 


io RAIN 

‘POWER 
How would you represent a house cat and a tiger, in an 
inheritance structure? Is a domestic cat a specialized 
version of a tiger? Which would be the subclass, and 


which would be the superclass? Or are they both 
subclasses to some other class? 


How would you design an inheritance structure? What 
methods would be overridden? 


Think about it. Before you turn the page. 
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Understanding Inheritance 


When you design with inheritance, you put common code in a 
class and then tell other more specific classes that the common 
(more abstract) class is their superclass. When one class inherits 
from another, the subclass inherits from the superclass. 


In Java, we say that the subclass extends the superclass. 

An inheritance relationship means that the subclass inherits the 
members of the superclass. When we say “members of a class,” 
we mean the instance variables and methods. For example if 
PantherMan is a subclass of SuperHero, the PantherMan class 
automatically inherits the instance variables and methods common 
to all superheroes including suit, tights, specialPower, 
useSpecialPower (), and so on. But the PantherMan sub- 
class can add new methods and instance variables of its 
own, and it can override the methods it inherits from the 
superclass SuperHero. 


superclass 


(more abstract] aie instance variables 
3 specialPower (state, attributes) 


useSpecialPower() methods 
putOnSuit() (behavior) 


subclasses 
(more specific) 


=> PantherMan Overriding 
LA 4 useSpecialPower() methods 


putOnSuit() — 


SS FriedEggMan doesn’t need any behavior that’s unique, 
pK so he doesn’t override any methods. The methods and 
Cc. variables in SuperHero are sufficient. 


PantherMan, though, has specific requirements for his suit 
and special powers, so uSseSpecialPower() and 
putOnSuit () are both overridden in the PantherMan 
class. 

Instance variables are not overridden because they 
don’t need to be. They don’t define any special behavior, so a 
subclass can give an inherited instance variable any value it 
chooses. PantherMan can set his inherited tights to 
purple, while FriedEggMan sets his to white. 


inheritance and polymorphism 


An inheritance example: 


public class Doctor { 


I inherited my 
procedures so I didn't 
bother with medical school. 
Relax, this won't hurt a bit. 
(now where did I put that 
power saw...) 


boolean worksAtHospital; 


void treatPatient() { 
// perform a checkup 


} 


public class FamilyDoctor extends Doctor { 
boolean makesHouseCalls; 


void giveAdvice() { 
// give homespun advice 


public class Surgeon extends Doctor { 


void treatPatient() { 
// perform surgery 


void makeIncision() { 
// make incision (yikes!) 


l erp your pencil 
superciass N 
How many instance variables does 


one instance variable Surgeon have?__ 


treatPatient () one method How many instance variables does 
FamilyDoctor have? 


How many methods does Doctor have? 


subclasses How many methods does Surgeon have? ____ 


| Surgeon e| How many methods does FamilyDoctor 
Surgeon 


Adds one new have? 
instance variable 


Overrides the inherited 


treatPatient() method | treatPatient () Can a FamilyDoctor do treatPatient()? 


a giveAdvice () Adds one new method 
Adds one new method | makelncision() Can a FamilyDoctor do makelncision()? 


—-» Yours to solve. 


youarehere> 171 


designing for inheritance 


Lets design the inheritance tree for 
an Animal simulation program 


Imagine you're asked to design a simulation program that lets the 
user throw a bunch of different animals into an environment to see 
what happens. We don’t have to code the thing now; we’re mostly 
interested in the design. 


We've been given a list of some of the animals that will be in 

the program, but not all. We know that each animal will be 
represented by an object and that the objects will move around in 
the environment, doing whatever it is that each particular type 1s 
programmed to do. 


And we want other programmers to be able to 
add new kinds of animals to the program at 
any time. 

First we have to figure out the common, abstract characteristics 


that all animals have, and build those characteristics into a class 
that all animal classes can extend. 


Look for objects that have common 
attributes and behaviors. 


What do these six types have in 
common? This helps you to abstract 
out behaviors. (step 2) 


How are these types related? This 
helps you to define the inheritance 
tree relationships (steps 4-5) 
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duplicating code in subclasses 


We have five instance variables: 


picture — the filename representing the JPEG of this animal. 


food — the type of food this animal eats. Right now, there can be 


only two values: meat or grass. 


hunger — an int representing the hunger level of the animal. It 
changes depending on when (and how much) the animal eats. 


boundaries — values representing the height and width of the 
“space” (for example, 640 x 480) that the animals will roam 


around in. 


location — the X and Y coordinates for where the animal is in 


the space. 


We have four methods: 


makeNoise() — behavior for when the animal is supposed to 


make noise. 


eat() — behavior for when the animal encounters its preferred 


food source, meat or grass. 


sleep() — behavior for when the animal is considered asleep. 


roam() — behavior for when the animal is not eating or sleeping 
(probably just wandering around waiting to bump into a food 


source or a boundary). 


Lion 


Hippo 


inheritance and polymorphism 


oO 


Design a class that represents 
the common state and behavior. 


These objects are all animals, so 
we'll make a common superclass 
called Animal. 


We'll put in methods and instance 
variables that all animals might 
need. 


picture 
food 
hunger 
boundaries 
location 


makeNoise() 
eat() 

sleep() 
roam() 
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designing for inheritance 


Do all animals eat the same way? 


Assume that we all agree on one thing: the instance 
variables will work for all Animal types. A lion will have 
his own value for picture, food (we’re thinking meat), 
hunger, boundaries, and location. A hippo will have 
different values for his instance variables, but he’ll still 
have the same variables that the other Animal types 
have. Same with dog, tiger, and so on. But what about 
behavior? 


Which methods should we override? 


Does a lion make the same noise as a dog? Does a cat 
eat like a hippo? Maybe in your version, but in ours, 
eating and making noise are Animal-type-specific. We 
can’t figure out how to code those methods in such a way 
that they’d work for any animal. OK, that’s not true. We 
could write the makeNoise() method, for example, so 
that all it does is play a sound file defined in an instance 
variable for that type, but that’s not very specialized. 
Some animals might make different noises for different 
situations (like one for eating, and another 
when bumping into an enemy, etc.) 
I'm one bad*ss 


So just as with the Amoeba 
plant-eater. 


overriding the Shape class rotate() 
method, to get more amoeba-specific 
(in other words, unique) behavior, 
we'll have to do the same for our Animal 
subclasses. 


Decide if a subclass 

needs behaviors (method 
implementations) that are specific 
to that particular subclass type. 


Looking at the Animal class, 

we decide that eat() and 
makeNoise() should be overridden 
by the individual subclasses. 


In the dog community, 
barking is an important 
part of our cultural identity. 
We have a unique sound, and we 
want that diversity to be 
recognized and respected. 


picture 

food 

hunger 0 
i . thods, eat! 

boundaries We better override these two met "i 

ce ard makeNoise(, so that eath animal type Can 


makeNoise() 
eat() roam\/ Can stay generit- 
sleep() 
roam() 
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behavior for eating and 


ine i üfie 
<—~ nee paige it looks like sleep and 


Looking for more inheritance 
opportunities 


The class hierarchy is starting to shape up. We 

have each subclass override the makeNovse() and eat() 
methods so that there’s no mistaking a Dog bark from 
a Cat meow (quite insulting to both parties). And a 
Hippo won’t eat like a Lion. 


But perhaps there’s more we can do. We have to look 
at the subclasses of Animal and see if two or more 
can be grouped together in some way, and given code 
that’s common to only that new group. Wolf and Dog 
have similarities. So do Lion, Tiger, and Cat. 


inheritance and polymorphism 


Q 


Look for more opportunities to use 

abstraction, by finding two or more 
subclasses that might need common 
behavior. 


We look at our classes and see 

that Wolf and Dog might have some 
behavior in common, and the same goes 
for Lion, Tiger, and Cat. 


picture 
food 
hunger 
boundaries 
location 


makeNoise() 


eat() 
Liom sleep() W 
der * roam olf and 
ron \ Scat ane ai : poyas the hoc ii oth Canines... 
Tiago 2r meno i elses ag that 
Ann 
Lion 
Wolf 
makeNoise() 
eat() 
Cat makeNoise() 
Hippo Tiger eat() 
- makeNoise() 
makeNoise() a eai 
eat() makeNoise() 


175 


you are here > 


designing for inheritance 


Q Finish the class hierarchy 


Since animals already have an organizational 
hierarchy (the whole kingdom, genus, phylum 
thing), we can use the level that makes the most 
sense for class design. We'll use the biological 
“families” to organize the animals by making a 
Feline class and a Canine class. 


We decide that Canines could use a common 
roam() method, because they tend to move in 
packs. We also see that Felines could use a 
common roam() method, because they tend to 
avoid others of their own kind. We'll let Hippo 
continue to use its inherited roam() method— 
the generic one it gets from Animal. 


So we're done with the design for now; we'll 
come back to it later in the chapter. 


Feline 
roam() 

Hippo 
makeNoise() 
eat() 

Lion 
makeNoise() 
eat() 
Cat 
Tiger 
makeNoise() 
eat() 
makeNoise() 
eat() 


rt 
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picture 
food 
hunger 
boundaries 
location 


makeNoise() 
eat() 

sleep() 
roam() 


Canine 


makeNoise() 
eat() 


LV 


makeNoise() 
eat() 


inheritance and polymorphism 


Which method is called? 


The Wolf class has four methods. One inherited 
from Animal, one inherited from Canine (which 
is actually an overridden version of a method in 
class Animal), and two overridden in the Wolf 
class. When you create a Wolf object and assign 
it to a variable, you can use the dot operator 

on that reference variable to invoke all four 
methods. But which version of those methods 


gets called? Añimal 
makeNoise() 
eat() 
sleep() 

Make a new Wolf object Wolf w = new Wolf(); roam() 

Calls the version in Wolf w.makeNoise(); 


Calls the version in Canine Canine 


= 


-roam(); 
Calls the version in Wolf w.eat (); 


Calls the version in Animal 


= 


-sleep(); 


When you call a method on an object refer- 
ence, youre calling the most specific version 


of the method for that object type. makeNoise() 


eat() 


In other words, the lowest one wins! 


“Lowest” meaning lowest on the inheritance 
tree. Canine is lower than Animal, and Wolf 
is lower than Canine, so invoking a method 
on a reference to a Wolf object means the 
JVM starts looking first in the Wolf class. If 
the JVM doesn’t find a version of the method 
in the Wolf class, it starts walking back up the 
inheritance hierarchy until it finds a match. 
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practice designing an inheritance tree 


Designing an Inheritance Tree 


Class 
Clothing 


Superclasses 


Clothing 


Inheritance Table 


Class Superclasses 


Musician 


Rock Star 


Bass Player 


a 


Subclasses 


Hint: not everything can be connected to something else. 
Hint: you're allowed to add to or change the classes listed. 


Q: You said that the JVM starts 
walking up the inheritance tree, 
starting at the class type you invoked 
the method on (like the Wolf example 
on the previous page). But what 
happens if the JVM doesn’t ever find 
a match? 
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A: Good question! But you don’t 
have to worry about that. The compiler 
guarantees that a particular method is 
callable for a specific reference type, 
but it doesn't say (or care) from which 
class that method actually comes from 
at runtime. With the Wolf example, the 
compiler checks for a sleep() method 
but doesn’t care that sleep() is actually 
defined in (and inherited from) class 
Animal. Remember that if a class 
inherits a method, it has the method. 


subclasses 
(more specific) 


~~ 


superclass 
(more abstract) 


N 


Clothing 


Inheritance Class Diagram 


Draw an inheritance diagram here. 


—— Yours to solve. 


Where the inherited method is defined 
(in other words, in which superclass 

it is defined) makes no difference to 
the compiler. But at runtime, the JVM 
will always pick the right one. And 
the right one means the most specific 
version for that particular object. 


Using IS-A and HAS-A 


Remember that when one class inherits 
from another, we say that the subclass 
extends the superclass. When you want to 
know if one thing should extend another, 
apply the IS-A test. 


Triangle IS-A Shape, yeah, that works. 
Cat IS-A Feline, that works too. 
Surgeon IS-A Doctor, still good. 


‘Tub extends Bathroom, sounds 
reasonable. 


Until you apply the IS-A test. 


To know if you've designed your types 
correctly, ask, “Does it make sense to say 
type X IS-A type Y?” If it doesn’t, you 
know there’s something wrong with the 
design, so if we apply the IS-A test, ‘Tub 
IS-A Bathroom is definitely false. 


What if we reverse it to Bathroom 
extends Tub? That still doesn’t work, 
Bathroom IS-A Tub doesn’t work. 


‘Tub and Bathroom are related, but not 
through inheritance. Tub and Bathroom 
are joined by a HAS-A relationship. 
Does it make sense to say “Bathroom 
HAS-A Tub”? If yes, then it means that 
Bathroom has a Tub instance variable. In 
other words, Bathroom has a reference to 

a Tub, but Bathroom does not extend Tub 
and vice versa. 


Tub 
int size; 
Bathroom Bubbles b; 
Tub bathtub; 
Sink theSink; 


Bathroom HAS-A Tub and Tub HAS-A Bubbles. 
But nobody inherits from (extends) anybody else. 


inheritance and polymorphism 


Does it make sense to saya 
Tub IS-A Bathroom? Or a Bathroom 
IS-A Tub? Well, it doesn't to me. The 
relationship between my Tub and my 
Bathroom is HAS-A. Bathroom HAS-A 
Tub. That means Bathroom has a 


Tub instance variable. 


Bubbles 


int radius; 
int colorAmt; 
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exploiting the power of objects 
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But wait! Theres more! 


The IS-A test works anywhere in the inheritance tree. If your 


inheritance tree is well-designed, the IS-A test should make sense 


when you ask any subclass if it IS-A any of its supertypes. 


If class B extends class A, class B IS-A class A. 


This is true anywhere in the inheritance tree. If 
class C extends class B, class C passes the IS-A 
test for both B and A. 


Canine extends Animal 
Wolf extends Canine 


Wolf extends Animal 


Canine IS-A Animal 
Wolf IS-A Canine 
Wolf IS-A Animal 


Animal 


makeNoise() 
eat() 

sleep() 
roam() 


Canine 


roam() 


Wolf 


makeNoise() 
eat() 


With an inheritance tree like the one 
shown here, you’re always allowed to 
say “Wolf extends Animal” or 
“Wolf IS-A Animal.” It makes no 
difference if Animal is the superclass 
of the superclass of Wolf. In fact, as 
long as Animal is somewhere in 
the inheritance hierarchy above 
Wolf, Wolf IS-A Animal will 
always be true. 


The structure of the Animal 
inheritance tree says to the world: 


“Wolf IS-A Canine, so Wolf can 
do anything a Canine can do. And 
Wolf IS-A Animal, so Wolf can do 


anything an Animal can do.” 


It makes no difference if Wolf 
overrides some of the methods in 
Animal or Canine. As far as the world 
(of other code) is concerned, a Wolf 
can do those four methods. How he 
does them, or in which class they’re 
overridden, makes no difference. A Wolf 
can makeNoise(), eat(), sleep(), and 
roam() because a Wolf extends from 
class Animal. 


How do you know if you've got 
your inheritance right? 


There’s obviously more to it than what we’ve 
covered so far, but we’ll look at a lot more OO 
issues in the next chapter (where we eventually 
refine and improve on some of the design work we 
did in this chapter). 


For now, though, a good guideline is to use the IS-A 
test. If “X IS-A Y” makes sense, both classes (X 
and Y) should probably live in the same inheritance 
hierarchy. Chances are, they have the same or 
overlapping behaviors. 


Keep in mind that the 
inheritance IS-A relationship 
works in only one direction! 


Triangle IS-A Shape makes sense, so you can have 
Triangle extend Shape. 


But the reverse—Shape IS-A Triangle—does not 
make sense, so Shape should not extend Triangle. 
Remember that the IS-A relationship implies that if 
X IS-A Y, then X can do anything a Y can do (and 
possibly more). 


—> Yours to solve. 


Roses are 


inheritance and polymorphism 


Java is 


harpen your pencil 
er 


Put a check next to the relationships that 
make sense. 


Oven extends Kitchen 


L] Guitar extends Instrument 


Person extends Employee 


Ferrari extends Engine 


FriedEgg extends Food 


Beagle extends Pet 


Container extends Jar 


Metal extends Titanium 


GratefulDead extends Band 


Blonde extends Smart 


Beverage extends Martini 


Hint: apply the IS-A test 
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who inherits what 


there, are_no 


Dumb Questions 


: So we see how a subclass gets 
to inherit a superclass method, but 
what if the superclass wants to use 
the subclass version of the method? 


A: A superclass won't necessarily 
know about any of its subclasses. 

You might write a class and much 
later someone else comes along and 
extends it. But even if the superclass 
creator does know about (and wants 
to use) a subclass version of a method, 


Q: In a subclass, what if | want to 
use BOTH the superclass version and 
my overriding subclass version of a 
method? In other words, | don’t want 
to completely replace the superclass 
version; | just want to add more stuff 
to it. 


A: You can do this! And it’s an 
important design feature. Think of the 
word “extends” as meaning “I want 

to extend the functionality of the 


You can design your superclass 
methods in such a way that they 
contain method implementations 
that will work for any subclass, even 
though the subclasses may still need to 
“append” more code. In your subclass 
overriding method, you can call the 
superclass version using the keyword 
super. It’s like saying, “first go run the 
superclass version, then come back 
and finish with my own code...” 


there’s no sort of reverse or backward 
inheritance. Think about it, children 
inherit from parents, not the other way 
around. 


superclass.” 


public void roam() { 
super .roam() ; 
// my own roam stuff 


This calls the inherited version o 
more then comes back to do your 
own subclass—specitie tode 


KR 


Who gets the Porsche, who gets the porcelain? 
(how to know what a subclass can “Samm 
inherit from its superclass) y a 


A subclass inherits members of the 
superclass. Members include instance “S 
variables and methods, although later in 
this book we’ll look at other inherited members. A 
superclass can choose whether or not it wants a 
subclass to inherit a particular member by the level of 
access the particular member is given. 


There are four access levels that we’ll cover in this book. 
Moving from most restrictive to least, the four access 
levels are: 


private default protected 


a 


public 
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Access levels control who sees what, and are crucial 
to having well-designed, robust Java code. For now we’ll 
focus just on public and private. The rules are simple for 
those two: 


public members are inherited 
private members are not inherited 


When a subclass inherits a member, it is as if the 
subclass defined the member itself. In the Shape 
example, Square inherited the rotate () and 
playSound() methods and to the outside world (other 
code) the Square class simply has a rotate () and 
playSound() method. 

The members of a class include the variables and 
methods defined in the class plus anything inherited 
from a superclass. 


Note: get more details about default and protected in 
Appendix B. 


When designing with inheritance, 
are you USING or abusing? 


Although some of the reasons behind these rules won’t be 
revealed until later in this book, for now, simply knowing a few 
rules will help you build a better inheritance design. 


DO use inheritance when one class is a more specific type of a 
superclass. Example: Willow is a more specific type of Tree, so 
Willow extends Tree makes sense. 


DO consider inheritance when you have behavior 
(implemented code) that should be shared among multiple 
classes of the same general type. Example: Square, Circle, 
and Triangle all need to rotate and play sound, so putting 
that functionality in a superclass Shape might make sense and 
makes for easier maintenance and extensibility. Be aware, 
however, that while inheritance is one of the key features of 
object-oriented programming, it’s not necessarily the best way 
to achieve behavior reuse. It’ll get you started, and often it’s 
the right design choice, but design patterns will help you see 
other more subtle and flexible options. If you don’t know about 
design patterns, a good follow-on to this book would be Head 
First Design Patterns. 


DO NOT use inheritance just so that you can reuse code 
from another class, if the relationship between the superclass 
and subclass violate either of the above two rules. For example, 
imagine you wrote special printing code in the Animal class 
and now you need printing code in the Potato class. You might 
think about making Potato extend Animal so that Potato 
inherits the printing code. That makes no sense! A Potato is not 
an Animal! (So the printing code should be in a Printer class 
that all printable objects can take advantage of via a HAS-A 
relationship.) 


DO NOT use inheritance if the subclass and superclass 

do not pass the IS-A test. Always ask yourself if the subclass 
IS-A more specific type of the superclass. Example: Tea IS-A 
Beverage makes sense. Beverage IS-A Tea does not. 


r BULLET POINTS 


inheritance and polymorphism 


Asubclass extends a superclass. 


A subclass inherits all public instance 
variables and methods of the superclass, but 
does not inherit the private instance variables 
and methods of the superclass. 


Inherited methods can be overridden; instance 
variables cannot be overridden (although they 
can be redefined in the subclass, but that’s 
not the same thing, and there’s almost never a 
need to do it.) 


Use the IS-A test to verify that your 
inheritance hierarchy is valid. If X extends Y, 
then X IS-A Y must make sense. 


The IS-A relationship works in only one 
direction. A Hippo is an Animal, but not all 
Animals are Hippos. 


When a method is overridden in a subclass, 
and that method is invoked on an instance of 
the subclass, the overridden version of the 
method is called. (The lowest one wins.) 


If class B extends A, and C extends B, class 
B IS-A class A, and class C IS-A class B, and 
class C also IS-A class A. 
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exploiting the power of objects 


So what does all this 
inheritance really buy you? 


You get a lot of OO mileage by designing with 
inheritance. You can get rid of duplicate code by 
abstracting out the behavior common to a group 
of classes, and sticking that code in a superclass. 
That way, when you need to modify it, you have 
only one place to update, and the change is magically 
reflected in all the classes that inherit that behavior 

Well, there’s no magic involved, but it zs pretty 
simple: make the change and compile the class 
again. That’s it. You don’t have to touch the 
subclasses! 


Just deliver the newly changed superclass, 
and all classes that extend it will 
automatically use the new version. 


A Java program is nothing but a pile of classes, 

so the subclasses don’t have to be recompiled in 
order to use the new version of the superclass. 

As long as the superclass doesn’t break anything 
for the subclass, everything’s fine. (We’ll discuss 
what the word “break” means in this context later 
in the book. For now, think of it as modifying 
something in the superclass that the subclass 

is depending on, like a particular method’s 
arguments, return type, method name, etc.) 
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You avoid duplicate 
code. 

Put common code in one place, and let 

the subclasses inherit that code froma 
superclass. When you want to change that 
behavior, you have to modify it in only 
one place, and everybody else (i.e., all the 
subclasses) sees the change. 


You define a common 
protocol for a group of 
classes. 


Um, what 
the heck does 
THAT mean? 


Inheritance lets you guarantee that 
all classes grouped under a certain 


supertype have all the methods that 


the supertype has* 


In other words, you define a common protocol for a 
set of classes related through inheritance. 


When you define methods in a superclass that can be inher- 
ited by subclasses, you’re announcing a kind of protocol to 
other code that says, “All my subtypes (1.e., subclasses) can 
do these things, with these methods that look like this...” 


In other words, you establish a contract. 


Class Animal establishes a common protocol for all Animal 
subtypes: 


You're telling the world that 
ie aa a Animal can do these tour 
see i includes the method 
aM That ine 
roam) d return types: 


roam() arguments an 


And remember, when we say any Animal, we mean Animal 
and any class that extends from Animal. That again means, any 
class that has Animal somewhere above it in the inheritance hierarchy. 


But we’re not even at the really cool part yet, because we 
saved the best—polymorphism—for last. 


When you define a supertype for a group of classes, any 
subclass of that supertype can be substituted where the supertype is 
expected. 


Say, what? 


Don’t worry, we’re nowhere near done explaining it. Two 
pages from now, you'll be an expert. 


*When we say “all the methods,” we mean “all the inheritable methods,” which 
for now actually means “all the public methods,” although later we'll refine that 
definition a bit more. 


inheritance and polymorphism 


And I care because... 


You get to take advantage of 
polymorphism. 


Which matters to me 
because... 


You get to refer to a subclass object 
using a reference declared as the super- 


type. 


And that means to me... 


You get to write really flexible code. 
Code that's cleaner (more efficient, 
simpler). Code that's not just easier to 
develop, but also much, much easier to 
extend, in ways you never imagined at 
the time you originally wrote your code. 


That means you can take that tropical 
vacation while your co-workers update 
the program, and your co-workers might 
not even need your source code. 


You'll see how it works on the next page. 


We don't know about you, but 
personally, we find the whole 
tropical vacation thing 
particularly motivating. 
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the way polymorphism works 


To see how polymorphism 
works, we have to step back 
and look at the way we 
normally declare a reference 
and create an object... 
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The 3 steps of object 
declaration and assignment 


1 2 
3 


ao oT OOO 
Dog myDog = new Dog(); 


Declare a reference 
variable 


Dog myDog = new Dog(); 


Tells the JVM to allocate space for a ref- 
erence variable. The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 


2) Create an object 


Dog myDog = new Dog (); 


Tells the JVM to allocate space for 
a new Dog object on the garbage 
collectible heap. 


Dog object 


Link the object 
and the reference 


Dog myDog = new Dog(); 


Assigns the new Dog to the refer- 
ence variable myDog. In other 
words, program the remote control. 


a object 


inheritance and polymorphism 


The important point is that the 
reference type AND the object 
type are the same. 


In this example, both are Dog. 


Qog ob\e 


These two are the same type. The reference 
variable type is declared as Dog, and the object 
is created as new Dog(). 


But with polymorphism, the 
reference type and the object 
type can be different. 


Animal myDog = new Dog(); 


Animal 
Animal 


These two are NOT the same type. The 
referente variable type is declared as Animal, 
but the object is created as new Dog(). 
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polymorphism in action 


With polymorphism, the reference 
type can be a superclass of the 


actual object type. Uh...nope. 
Still not gettin’ it. 


When you declare a reference variable, any 
object that passes the IS-A test for the type 
of the reference can be assigned to that 


variable. In other words, anything that 
extends the declared reference variable type 
can be assigned to the reference variable. 
This lets you do things like make 
polymorphic arrays. 


ds) 
miwal. In ag ene 
an avray of ves of tyre i 


OK, OK maybe an example will help. j $ 
iat will hela 2 


Declare 
an array 


Animal[] animals = new Animal[5]; 


animals[0] = new Dog(); 
a eens But look what you get to do...you tan put ANY subclass 
animals[2] = new Wolf(); € of Animal in the Animal array! 
animals[3] = new Hippo (); 
animals[4] = new Lion(); And here’ h 
sa, Che be 
es d'étre for the oiner Phie Part (the 
‘0 e 
for (Animal animal : animals) { of the Anke rugh the rray A : 
object does ass method d Call one 


animal .eat () ; re. 
On the first pass through the loop, ‘animal’ is a Dog, 


+ the Doo’s eat() method. On the next pass, 
animat-roam(); a: a Cat, 2 you get the Cat’s eat) method. 


Came with roam(). 
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inheritance and polymorphism 


But wait! There’s more! 


You can have polymorphic 
arguments and return types. 
——_ 


If you can declare a reference variable of a 
supertype, say, Animal, and assign a subclass 


object to it, say, Dog, think of how that might ~ 
work when the reference is an argument to a b Š 


method... 


class Vet { 


public void giveShot (Animal a) { Theta 
i , , t € a Parameter can take ANY Ani 
// do horrible things to the Animal at mi as the argument Ánd wh Mids 

IS done oj a en the V 
// the other end of the ‘a’ parameter emo the shot, it tells 
really out 


a.makeNoise() ; makeNoise 


Q method will neal that's whose 


class PetOwner { 


) à k 3 
public void start() { bes has ST a ap 
imal you 9' : 
Vet vet = new Vet (); ase in as the argument is a subelass o 
pene it will work. 


Dog dog = new Dog(); 
Hippo hippo = new Hippo(); 

) 4 
vet.giveShot (dog); @— Dog's makeNoisel) runs 


vet .giveShot (hippo) ; ee 
g (hippo) ha Hippo’s makeNoise() vine 


youarehere> 189 


exploiting the power of polymorphism 


NOW I get it! If I write 
my code using polymorphic arguments, 
where I declare the method parameter as a 
superclass type, I can pass in any subclass object at 

runtime. Cool. Because that also means I can write my 


code, go on vacation, and someone else can add new 
subclass types to the program and my methods will 
still work... (the only downside is I'm just making life 
easier for that idiot Jim). 


bi With polymorphism, you can write code that doesnt 
have to change when you introduce new subclass 
types into the program. 


Remember that Vet class? If you write that Vet class using 
arguments declared as type Animal, your code can handle any 
Animal subclass. That means if others want to take advantage of 
your Vet class, all they have to do is make sure their new Animal types 
extend class Animal. The Vet methods will still work, even though 
the Vet class was written without any knowledge of the new Animal 


subtypes the Vet will be working on. 


gWe RAIN 

POWER 
Why is polymorphism guaranteed to work this way? Why is 
it always safe to assume that any subclass type will have the 


methods you think you're calling on the superclass type (the 
superclass reference type you're using the dot operator on)? 
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Dumb Questions 


Q: Are there any practical limits 
on the levels of subclassing? How 
deep can you go? 


A: If you look in the Java API, 
you'll see that most inheritance 
hierarchies are wide but not deep. 
Most are no more than one or two 
levels deep, although there are 
exceptions (especially in the GUI 
classes). You'll come to realize that 
it usually makes more sense to keep 
your inheritance trees shallow, but 
there isn’t a hard limit (well, not one 
that you'd ever run into). 


: Hey, I just thought of 
something...if you don’t have access 
to the source code for a class but you 
want to change the way a method 
of that class works, could you use 
subclassing to do that? To extend 
the “bad” class and override the 
method with your own better code? 


A: Yep. That’s one cool feature 

of OO, and sometimes it saves you 
from having to rewrite the class 

from scratch or track down the 
programmer who hid the source code. 


Q: Can you extend any class? Or 
is it like class members where if the 
class is private you can’t inherit it... 


A: There’s no such thing as a 
private class, except in a very special 
case called an inner class, which we 
haven't looked at yet. But there are 
three things that can prevent a class 
from being subclassed. 


The first is access control. Even 
though a class can’t be marked 
private, a class can be non-public 
(what you get if you don’t declare the 
class as public). A non-public class 
can be subclassed only by classes in 
the same package as the class. Classes 
in a different package won't be able to 
subclass (or even use, for that matter) 
the non-public class. 


The second thing that stops a class 
from being subclassed is the keyword 
modifier final. A final class means 
that it’s the end of the inheritance 
line. Nobody, ever, can extend a final 
class. 


The third issue is that if a class has 
only private constructors (we'll 
look at constructors in Chapter 9), it 
can’t be subclassed. 


inheritance and polymorphism 


Q: Why would you ever want to 

make a final class? What advantage 
would there be in preventing a class 
from being subclassed? 


A: Typically, you won't make 
your classes final. But if you need 


security—the security of knowing 
that the methods will always work the 
way that you wrote them (because 
they can’t be overridden), a final class 
will give you that. A lot of classes in 
the Java API are final for that reason. 
The String class, for example, is final 
because, well, imagine the havoc if 
somebody came along and changed 
the way Strings behave! 


- Can you make a method final, 
without making the whole class 
final? 


A: If you want to protect a specific 
method from being overridden, mark 


the method with the final modifier. 
Mark the whole class as final if you 
want to guarantee that none of the 
methods in that class will ever be 
overridden. 
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overriding methods 


Keeping the contract: rules for overriding 


When you override a method from a superclass, you’re agreeing to fulfill the contract. 
The contract that says, for example, “I take no arguments and I return a boolean.” In 
other words, the arguments and return types of your overriding method must look to 

the outside world exactly like the overridden method in the superclass. 


The methods are the contract. 


If polymorphism is going to work, the Toaster’s version of the overridden method 
from Appliance has to work at runtime. Remember, the compiler looks at the 
reference type to decide whether you can call a particular method on that reference. 


Appliance appliance 
——— 


Referente EY Object: type 


With an Appliance reference to a Toaster, the compiler cares only if class 
Appliance has the method you’re invoking on an Appliance reference. But at 
runtime, the JVM does not look at the reference type (Appliance) but at the 


new Toaster (); 


Appliance 


boolean turnOn() 


boolean turnOff() 


Toaster 


boolean turnOn(int level) 


actual Toaster object on the heap. This 1s or an 
So if the compiler has already approved the method call, the only way it override, khe 
can work is if the overriding method has the same arguments and return Cant change an 
types. Otherwise, someone with an Appliance reference will call turnOn() as arguments method! 
a no-arg method, even though there’s a version in Toaster that takes an int. overriding This is actually a leoal 
Which one is called at runtime? The one in Appliance. In other words, the overLOAD, but A a 
turnOn(int level) method in Toaster is not an override! overR|DE. 
@ Arguments must be the same, and return 
types must be compatible. 
The contract of superclass defines how other code can use a method. 
Whatever the superclass takes as an argument, the subclass over- Appliance 
riding the method must use that same argument. And whatever the 
superclass declares as a return type, the overriding method must de- f 
: public boolean turnOn() 
clare either the same type or a subclass type. Remember, a subclass 
object is guaranteed to be able to do anything its superclass declares, public boolean turnOff() 
so it’s safe to return a subclass where the superclass is expected. 
@ The method can’t be less accessible. 
That means the access level must be the same, or friendlier. You 
can't, for example, override a public method and make it private. 
What a shock that would be to the code invoking what it thinks (at NOT LEGAL! 
compile time) is a public method, if suddenly at runtime the JVM \eoal N Toaster 
slammed the door shut because the overriding version called at It's not a leg se You 
runtime is private! overide wan at- , 
restrit ed the & ‘ private boolean turnOn() 
So far we've learned about two access levels: private and public. tess leve Nor SD 
The other two are in appendix B. There’s also another rule about 3 \egal over LOAL 4 
overriding related to exception handling, but we'll wait until Chap- because YoY didn 


ter 13, Risky Behavior, to cover that. 
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Overloading a method 


Method overloading is nothing more than having two 
methods with the same name but different argument 
lists. Period. There’s no polymorphism involved with 
overloaded methods! 


Overloading lets you make multiple versions of a 
method, with different argument lists, for convenience 
to the callers. For example, if you have a method that 
takes only an int, the calling code has to convert, say, 
a double into an int before calling your method. But 
if you overloaded the method with another version 
that takes a double, then you’ve made things easier for 
the caller. You'll see more of this when we look into 
constructors in Chapter 9, Life and Death of an Object. 


Since an overloading method isn’t trying to fulfill 
the polymorphism contract defined by its superclass, 
overloaded methods have much more flexibility. 


@ The return types can be 
different. 


You're free to change the return types in 
overloaded methods, as long as the argument lists 
are different. 


@ You can’t change ONLY the 
return type. 


If only the return type is different, its not a 
valid overload—the compiler will assume 
you're trying to override the method. And even 
that won't be legal unless the return type is 

a subtype of the return type declared in the 
superclass. To overload a method, you MUST 
change the argument list, although you can 
change the return type to anything. 


®© You can vary the access 
levels in any direction. 
You’re free to overload a method with a method 
that’s more restrictive. It doesn’t matter, since the 


new method isn’t obligated to fulfill the contract of 
the overloaded method. 


inheritance and polymorphism 


An overloaded method is 

just a different method that 
happens to have the same 
method name. It has nothing 
to do with inheritance and 
polymorphism. An overloaded 
method is NOT the same as an 
overridden method. 


Legal examples of method 
overloading: 


public class Overloads { 


} 


} 


public double addNums (double a, 
return a + b; 


} 


} 


} 


String uniquelID; 


public int addNums(int a, int b) { 
return a + b; 


public void setUniqueID (String theID) { 
// lots of validation code, and then: 
uniqueID = theID; 


public void setUniqueID(int ssNumber) { 
String numString = "" + ssNumber; 
setUniqueID (numString) ; 


you are here > 


double b) 


{ 
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exercise: Mixed Messages 


— 


The program: 


class A { 
int ivar 


void m1() { 

System. out.print ("A's m1, 
} 
void m2() { 

System. out.print ("A's m2, 
} 
void m3() { 

System. out.print ("A's m3, 
} 

} 


class B extends A { 
void m1() { 
System. out.print ("B's m1, 
} 
} 


Code aa 
. Cc. 
candidates: =. m3); 
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S 


Mixed 
Messages 


A short Java program is listed below. One block of 
the program is missing! Your challenge is to match 
the candidate block of code (on the left), with the 
output that you'd see if the block were inserted. 
Not all the lines of output will be used, and some of 
the lines of output might be used more than once. 
Draw lines connecting the candidate blocks of 
code with their matching command-line output. 


class C extends B { 
void m3() { 
System.out.print ("C's m3, " + (ivar + 6)); 
} 
} 


public class Mixed2 { 
public static void main(String[] args) { 
Aa = new A(); 
Bb new B(); 

C c = new C(); 

A a2 = new C(); 


Candidate code 
goes here 
(three lines) 


A’s ml, A’s m2, C’s m3, 6 


B’s ml, A’s m2, A’s m3, 
A’s ml, B’s m2, A’s m3, 
B’s ml, A’s m2, C’s m3, 13 


B’s ml, C’s m2, A’s m3, 


B’s ml, A’s m2, C’s m3, 6 


A's ml, A’s m2, C’s m3, 13 


— > [Answers on page 197. 


inheritance and polymorphism 


BE the Compiler 


Which of the A-B pairs of methods listed on the right, if 
inserted into the classes on the left, would compile and 
produce the output shown? (The A method inserted into 
class Monster, the B method inserted into class Vampire.) 


public class MonsterTestDrive { 
1 boolean frighten(int d) { 
System.out.println("arrrgh") ; 


public static void main(String[] args) { Q i hi 
return true; 


Monster[] monsters = new Monster [3]; 


} 
boolean frighten (int x) { 
'B) System.out.printin("a bite?"); 


monsters[0] = new Vampire (); 


monsters [1] 


new Dragon () ; 


monsters[2] = new Monster (); return false; 
for (int i = 0; i < monsters.length; i++) { } 
monsters [i] . frighten (i); 
} 2 boolean frighten(int x) { 
} Q System.out.println("arrrgh"); 
} return true; 
} 
class Monster { int frighten(int f) { 
System.out.printin("a bite?"); 
A) return 1; 
} } 
, 3 boolean frighten (int x) { 
class Vampire extends Monster { O System.out.println("arrrgh"); 
B) return false; 
} 
} boolean scare (int x) { 


o System.out.printin("a bite?"); 


class Dragon extends Monster { return true; 


boolean frighten(int degree) { } 
System.out.println ("breathe fire"); 
return true; 4 boolean frighten(int z) { 
} Q System.out.printin("arrrgh"); 
} return true; 


} 

% java MonsterTestDrive (B) System.out.printin("a bite?"); 
a bite? return true; 

breathe fire } 

arrrgh 


> Answers on page 197. 
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puzzle: Pool Puzzle 


À Posl Puzzle 


Your job is to take code snippets from the pool and place them into 

the blank lines in the code. You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don't be fooled—this one’s harder than it looks. 


Gy 
>? 


public class Rowboat 


{ public class TestBoats { 
public rowTheBoat () { main(String[] args) { 
System.out.print ("stroke natasha"); ——— bil = new Boat (); 
} Sailboat b2 = new Q; 
} Rowboat = new Rowboat (); 
public class { b2.setLength (32) ; 
private int i bl. (i 
void ( ){ b3. —(); 
length = len; .move (); 
} } 
public int getLength() { } 
; public class Boat { 
} public O { 
public move() { System.out.print (" "); 
System.out.print (" —"); } 
; } 
} 


OUTPUT: 


drece 


drift hoist sail 


Rowboat 
Sailboat subclasses 


Boat 
a Testboats extends rift 
int len . hoist sail TheB s 
continue . String rowTheBoat 
- int length move 
b1 break mee i id setLength 
: int b3 voi i 
int b2 ; public 
b2 p3 length } int static . stroke natasha 
ian int b2 private 


getLength 
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———— Answers on page 198. 


Exercise Sotutions 


inheritance and polymorphism 


BE the Compiler (from page 195) 


Set 1 will work. 


Set 2 will not compile because of Vampire's return 
type (int). 

The Vampire’s frighten() method (B) is not a legal 
override OR overload of Monster’s frighten() method. 
Changing ONLY the return type is not enough 

to make a valid overload, and since an int is not 
compatible with a boolean, the method is not a valid 
override. (Remember, if you change ONLY the return 
type, it must be to a return type that is compatible 
with the superclass version’s return type, and then it’s 
an override.) 


Sets 3 and 4 will compile but produce: 
arrrgh 

breathe fire 

arrrgh 


Remember, class Vampire did not override class 
Monster’s frighten() method. (The frighten() method 
in Vampire’s set 4 takes a byte, not an int.) 


Code 
candidates: 


RY, 
Q + 
Mixed 


Messages 
(from page 194) 


Output: 


B’s ml, A’s m2, A’s m3, 
A’s ml, B’s m2, A’s m3, 
B’s ml, A’s m2, C’s m3, 13 
B’s ml, C’s m2, A’s m3, 


B’s ml, A’s m2, C’s m3, 6 


a2.ml1(); 


A’s ml, A’s m2, 
a2.n2i); } 


a2.m3(); 


m3, 13 


you are here > 
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puzzle answers 


oo] Puzzle 
(from page 196) 
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public class Rowboat extends Boat { 


public void rowTheBoat() { 


System.out.print ("Stroke natasha"); 


} 


public class Boat { 


private int length ; 

public void setLength ( intlen ) { 
length = len; 

} 

public int getLength() { 
return length ; 

} 

public void move() { 
System.out.print ("drift ") ; 


public class TestBoats { 


} 


public static void main(String[] args) { 
Boat b1 = new Boat(); 
Sailboat b2 = new Sailboat) ; 
Rowboat b3 = new Rowboat (); 
b2.setLength (32); 
b1.move () ; 
b3.move () ; 
b2.move () ; 

} 


public class Sailboatextends Boat { 


public void move () { 
System.out.print ("hoist sail ") ; 


(0U drift drift hoist sail 


8 interfaces and abstract classes 


Serious Polymorphism 


Inheritance is just the beginning. To exploit polymorphism, we need interfaces 
(and not the GUI kind). We need to go beyond simple inheritance to a level of flexibility and 
extensibility you can get only by designing and coding to interface specifications. Some of the 
coolest parts of Java wouldn't even be possible without interfaces, so even if you don’t design 
with them yourself, you still have to use them. But you'll want to design with them. You'll need 
to design with them. You’ll wonder how you ever lived without them. What's an interface? 

It's a 100% abstract class. What’s an abstract class? It’s a class that can’t be instantiated. What's 
that good for? You'll see in just a few moments. But if you think about the end of the previous 
chapter, and how we used polymorphic arguments so that a single Vet method could take 
Animal subclasses of all types, well, that was just scratching the surface. Interfaces are the poly 


in polymorphism. The ab in abstract. The caffeine in Java. 
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designing with inheritance 


Vid we forget about something 
when we designed this? 


The class structure isn’t too bad. We’ve designed it so 
that duplicate code is kept to a minimum, and we’ve 
overridden the methods that we think should have 
subclass-specific implementations. We’ve made it nice 
and flexible from a polymorphic perspective, because 
we can design Animal-using programs with Animal 
arguments (and array declarations) so that any Animal 
subtype—including those we never imagined at 
the time we wrote our code—can be passed in and 
used at runtime. We’ve put the common protocol for 
all Animals (the four methods that we want the world 
to know all Animals have) in the Animal superclass, 
and we’re ready to start making new Lions and Tigers 
and Hippos. 


Feline 
roam() 
Lion 
makeNoise() 
eat() 
Cat 
Tiger 
makeNoise() 
eat() 
makeNoise() 


eat() 


oa * 
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Hippo 


makeNoise() 
eat() 


picture 
food 
hunger 
boundaries 


location 


makeNoise() 
eat() 

sleep() 
roam() 


Canine 


eat() 


makeNoise() 
eat() 


makeNoise() 


interfaces and polymorphism 


We know we Can Say: 


Wolf aWolf = new Wolf(); 


A Wolf reference to a 


Cal 
Wolf object. Wolf -= ban Nore abe’ 


These two are the same type. 


And we know we can Say: 


Animal aHippo = new Hippo(); 


Animal reference to a 


Hippo object. “4p GHE 
R Animal ~ ban Po ob}? 


These two are NOT the same type. 


But here’s where it gets weird: 


Animal anim = new Animal (); 
ee 


- > a Thimal coe 
Animal = 


These two are the same type, but... 
what the heck does an Animal object look like? 


Animal reference to 
an Animal object. 
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when objects go bad 


What does a new Animal() object 
look like? 


seary objects 


What are the instance variable values? 


Some classes just should not be 


instantiated! 
It makes sense to create a Wolf object or a Hippo object in the first place (to use it as a polymorphic argument or 
or a Tiger object, but what exactly 7s an Animal object? return type, or to make a polymorphic array). 


is it? i f legs... TE 3 i 
What shape is it? What color, size, number of legs When yov’re designing your class inheritance structure, 


Trying to create an object of type Animal is like a you have to decide which classes are abstract and which 
nightmare Star Trek™ transporter accident. are concrete. Concrete classes are those that are specific 
The one where somewhere in the beam-me-up process enough to be instantiated. A concrete class just means that 
something bad happened to the buffer. it’s OK to make objects of that type. 

But how do we deal with this? We need an Animal Making a class abstract is easy—put the keyword 

class, for inheritance and polymorphism. But we want abstract before the class declaration: 


programmers to instantiate only the less abstract subclasses 
of class Animal, not Animal itself. We want Tiger objects 


and Lion objects, not Animal objects. abstract class Canine extends Animal { 
Fortunately, there’s a simple way to prevent a class from public void roam() { } 
ever being instantiated. In other words, to stop anyone } 


from saying “new” on that type. By marking the class as 
abstract, the compiler will stop any code, anywhere, 
from ever creating an instance of that type. 


You can still use that abstract type as a reference type. In 
fact, that’s a big part of why you have that abstract class 
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interfaces and polymorphism 


The compiler won't let you instantiate 
an abstract class 


An abstract class means that nobody can ever make a new instance 
of that class. You can still use that abstract class as a declared refer- 
ence type, for the purpose of polymorphism, but you don’t have to 
worry about somebody making objects of that type. The compiler 
guarantees it. 


abstract public class Canine extends Animal 


{ 
public void roam() { } 
} 
public class MakeCanine { gn always assign — 
public void go() This is OX, ae cae referente 
: . pelass ob =a ab att 
Canine c; e se he une a ss is 30S 
c = new Dog(); 
= e i ; 
c new Canine () é elis NN a 
c.roam() ; Compiler wi il N rked abstr 
or | act, so th 
} et You do this" 


File Edit Window Help BeamMeUp 


% javac MakeCanine. java 


MakeCanine.java:5: Canine is abstract; 


cannot be instantiated 


c = new Canine(); 
A 


An abstract class has virtually* no use, no value, no 
purpose in life, unless it is extended. 


With an abstract class, it’s the instances of a subclass of 
your abstract class that’s doing the work at runtime 


*There is an exception to this—an abstract class can have 
static members (see Chapter 10). 
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abstract and concrete classes 


Abstract vs. Concrete 


A class that’s not abstract is called 

a concrete class. In the Animal 
inheritance tree, if we make Animal, 
Canine, and Feline abstract, that 
leaves Hippo, Wolf, Dog, Tiger, Lion, 
and Cat as the concrete subclasses. 


Flip through the Java API and 
you'll find a lot of abstract classes, 
especially in the GUI library. What 
does a GUI Component look 

like? The Component class is the 
superclass of GUI-related classes 
for things like buttons, text areas, 
scrollbars, dialog boxes, you name 
it. You don’t make an instance of a 
generic Component and put it on the 
screen; you make a JButton. In other 
words, you instantiate only a concrete 
subclass of Gomponent, but never 
Component itself. 


ioe AUN 
POWER 


Hmmmm...do I 
feel like red or 
white tonight? 
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tonerete 


Hmmmm...the Camelot 
Vineyards 1997 Pinot 
Noir was a pretty 
decent year... 


abstract 


tontrete 
Cat 


tontrete 


Tiger | 
A Py 


abstract 


Animal 


abstract 


Abstract or concrete? 


How do you know when a class should be 
abstract? Wine is probably abstract. But what 
about Red and White? Again probably abstract 
(for some of us, anyway). But at what point in the 
hierarchy do things become concrete? 


Do you make PinotNoir concrete, or is it abstract 
too? It looks like the Camelot Vineyards 1997 
Pinot Noir is probably concrete no matter what. 


But how do you know for sure? 


Look at the Animal inheritance tree above. Do the 
choices we've made for which classes are abstract 
and which are concrete seem appropriate? 
Would you change anything about the Animal 
inheritance tree (other than adding more 
Animals, of course)? 


Abstract methods 


interfaces and polymorphism 


Besides classes, you can mark methods abstract, too. An abstract class 


means the class must be extended; an abstract method means the method 
must be overridden. You might decide that some (or all) behaviors in an 
abstract class don’t make any sense unless they’re implemented by a more 
specific subclass. In other words, you can’t think of any generic method 
implementation that could possibly be useful for subclasses. What would a 


generic eat() method look like? 


An abstract method has no body! 


Because you’ve already decided there isn’t any code that would make 
sense in the abstract method, you won’t put in a method body. So no curly 


braces— just end the declaration with a semicolon. 


public abstract void eat(); 


No method body! 
End it with a sem 


If you declare an abstract method, you MUST 
mark the class abstract as well. You can’t have 
an abstract method in a non-abstract class. 


If you put even a single abstract method in a class, you have to make 
the class abstract. But you can mix both abstract and non-abstract 


methods in the abstract class. 


there, are no 


itolon. 


It really sucks to 
be an abstract method. 
You don't have a body. 


re 


Dumb Questions 


7 What is the point of an abstract method? I thought 
the whole point of an abstract class was to have common 
code that could be inherited by subclasses. 


A: Inheritable method implementations (in other words, 
methods with actual bodies) are A Good Thing to put ina 
superclass. When it makes sense. And in an abstract class, it 
often doesn’t make sense, because you can’t come up with 
any generic code that subclasses would find useful. The 
point of an abstract method is that even though you haven't 
put in any actual method code, you've still defined part of 
the protocol for a group of subtypes (subclasses). 


Q: 


A: Polymorphism! Remember, what you want is the 
ability to use a superclass type (often abstract) as a method 
argument, return type, or array type. That way, you get 

to add new subtypes (like a new Animal subclass) to your 
program without having to rewrite (or add) new methods 
to deal with those new types. Imagine how you'd have to 
change the Vet class, if it didn’t use Animal as its argument 
type for methods. You'd have to have a separate method 
for every single Animal subclass! One that takes a Lion, one 
that takes a Wolf, one that takes a...you get the idea. So with 
an abstract method, you're saying, “All subtypes of this type 
have THIS method” for the benefit of polymorphism. 


Which is good because... 
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you must implement abstract methods 


206 


You MUST implement all abstract methods 


Implementing an abstract 
method is just like 
overriding a method. 


I have wonderful news, 
mother. Joe finally implemented 
all his abstract methods! Now 
everything is working just the 
way we planned... 


Abstract methods don’t have a body; they exist solely for polymorphism. That means the 


first concrete class in the inheritance tree must implement all abstract methods. 


You can, however, pass the buck by being abstract yourself. If both Animal and Canine 


are abstract, for example, and both have abstract methods, class Canine does not have to 


implement the abstract methods from Animal. But as soon as we get to the first concrete 


subclass, like Dog, that subclass must implement all of the abstract methods from both 


Animal and Canine. 


But remember that an abstract class can have both abstract and non-abstract methods, 


so Canine, for example, could implement an abstract method from Animal, so that Dog 
didn’t have to. But if Canine says nothing about the abstract methods from Animal, Dog 
has to implement all of Animal’s abstract methods. 


When we say “you must implement the abstract method,” that means you must provide 


a body, That means you must create a non-abstract method in your class with the same 


method signature (name and arguments) and a return type that is compatible with the 


declared return type of the abstract method. What you put în that method is up to you. 
All Java cares about is that the method is there, in your concrete subclass. 
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Ge Sharpen your pencil 
ee your p 


—> Yours to solve. 


Concrete 


golf course simulation 


satellite photo application 


interfaces and polymorphism 


Abstract versus Concrete classes 


Let’s put all this abstract rhetoric into some concrete use. In the middle 
column we've listed some classes. Your job is to imagine applications 
where the listed class might be concrete, and applications where the listed 
class might be abstract. We took a shot at the first few to get you going. 
For example, class Tree would be abstract in a tree nursery program, where 
differences between an Oak and an Aspen matter. But in a golf simulation 
program, Tree might be a concrete class (perhaps a subclass of Obstacle), 
because the program doesn't care about or distinguish between different 
types of trees. (There’s no one right answer; it depends on your design.) 


Sample class Abstract 


Tree tree nursery application 
House architect application 


Town 


Football Player coaching application 


Chair 


Customer 


Sales Order 


Book 


Store 


Supplier 


Golf Club 


Carburetor 


Oven 
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polymorphism examples 


Polymorphism in action 


Let’s say that we want to write our own kind of list class, one that will hold Dog 
objects, but pretend for a moment that we don’t know about the ArrayList class. 
For the first pass, we'll give it just an add() method. We’ll use a simple Dog array 
(Dog{]) to keep the added Dog objects, and give it a length of 5. When we reach 
the limit of 5 Dog objects, you can still call the add() method, but it won’t do 
anything. If we’re not at the limit, the add() method puts the Dog in the array at 
the next available index position and then increments that next available index 


(nextIndex). 
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‘Si, 
aS 2. 


MyDogList 


Dog|] dogs 
int nextIndex 


add(Dog d) 


chapter 8 


public class MyDogList { Use a plain ol 


Building our own Dog-specific list 


(Perhaps the world’s worst attempt at making our 
own ArrayList kind of class, from scratch.) 


à Dog array 


rA behind the stenes- 
private Dog[] dogs = new Dog[5]; 


private int nextIndex = 0; <—_ We'll intrement this eath time 
3 new Dog is added. 


public void add (Dog d) { SAk 
j If we've not already at the limit 
if (nextIndex < dogs.length) { of the dogs array) add the Dog 


‘ aqe. 
dogs [nextIndex] = d; and print a messay 
System.out.printin("Dog added at " + nextIndex) ; 


nextIndex++; <— increment, to ai 
index to ee give us the next 


interfaces and polymorphism 


Uh-oh, now we need to keep Cats, too 


We have a few options here: 
1. Make a separate class, MyCatList, to hold Cat objects. Pretty clunky. 


2. Make a single class, DogAndCatLust, that keeps two different arrays as instance 
variables and has two different add() methods: addCat(Cat c) and addDog(Dog d). 
Another clunky solution. 


3. Make a heterogeneous AnimalList class that takes any kind of Animal subclass 

(since we know that if the spec changed to add Cats, sooner or later we’ll have some 
other kind of animal added as well). We like this option best, so let’s change our class to 
make it more generic, to take Animals instead of just Dogs. We’ve highlighted the key 
changes (the logic 1s the same, of course, but the type has changed from Dog to Animal 
everywhere in the code). 


Building our own Animal-specific list 


er 
al objects w im 
public class MyAnimalList { new Anim oai of NRE Arim 
si new acca °) annot make a new 
PEN er u 
‘oy private Animal[] animals = new Animal[5]; (Remem ry a stratt tyre 
private int nextIndex = 0; ietan an array 2 ye 
MyAnimalList ou CA Tee BOLD that type 
public void add (Animal a) { declare 
Animall] animals if (nextIndex < animals.length) { 
int nextIndex animals [nextIndex] = a; 
WH System.out.printin("Animal added at " + nextIndex) ; 
add(Animal a) next Index++; 
} 
} 


public class AnimalTestDrive { 
public static void main(String[] args) { 
MyAnimalList list = new MyAnimalList (); 
Dog dog = new Dog(); 
Cat cat = new Cat(); 
list .add (dog) ; 
list .add (cat); 


File Edit Window Help Harm 


% java AnimalTestDrive 


Animal added at 0 


Animal added at 1 
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the ultimate superclass: Object 


What about non-Animals? Why not make 
a class generic enough to take anything? 


You know where this is heading. We want to change the type of the 
array, along with the add() method argument, to something above 
Animal. Something even more generic, more abstract than Animal. 
But how can we do it? We don’t have a superclass for Animal. 


Then again, maybe we do... 


Every class in Java extends 
class Object. 


Class Object is the mother of all classes; it’s the superclass of 
everything. 


Even if you take advantage of polymorphism, you still have to cre- 


ate a class with methods that take and return your polymorphic type. 


Without a common superclass for everything in Java, there’d be no 
way for the developers of Java to create classes with methods that 
could take your custom types...dypes they never knew about when they wrote 
the library class. 


So you were making subclasses of class Object from the very 
beginning and you didn’t even know it. Every class you write 
extends Object, without your ever having to say it. But you can 
think of it as though a class you write looks like this: 


public class Dog extends Object { } 


But wait a minute, Dog already extends something, Canine. That’s 
OK. The compiler will make Canine extend Object instead. Except 
Canine extends Animal. No problem, then the compiler will just 
make Animal extend Object. 


Any class that doesn’t explicitly extend another 
class, implicitly extends Object. 


So, since Dog extends Canine, it doesn’t directly extend Object 
(although it does extend it indirectly), and the same is true for 
Canine, but Animal does directly extend Object. 
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Object 


boolean equals() 
Class getClass() 
int hashCode() 

String toString() 


Animal doesn t 


makeNoise() expat suit 
t aw m! ? 
st sem ee a 
a subtiass of Obje 


roam() 


Canine 


makeNoise() 
eat() 


interfaces and polymorphism 


So what's in this ultra-super-megaclass Object? 


If you were Java, what behavior would you want every 
object to have? Hmmmm...let’s see...how about a 
method that lets you find out if one object is equal to 
another object? What about a method that can tell you 
the actual class type of that object? Maybe a method 
that gives you a hashcode for the object, so you can use 
the object in hashtables (we’ll talk about Java’s hashtables 
later). Oh, here’s a good one—a method that prints out a 
String message for that object. 


And what do you know? As if by magic, class Object 
does indeed have methods for those four things. That’s 
not all, though, but these are the ones we really care 
about. 


@ equals(Object o) 


Dog a 
Cat c 


= new Dog(); 
= new Cat(); 
if (a.equals(c)) { 
System. out .printin ("true"); 
} else { 
System. out .printin ("false"); 


File Edit Window Help Stop 


consi ered equal - 


@ getClass() 


Cat c = new Cat(); 
System.out .printin(c.getClass()); 


File Edit Window Help Faint 
Gives yo 


java TestObject 


class Cat 


u back the class that 
object was instantiated from. 


Object 
boolean equals() a of 
Class getClass() È just SOME of the methods 
int hashCode() class Object 
String toString() 


YourClassHere 


Every Class You write inherits 

all th 
methods of elass Object. The fe 
youve written inherited methods You 
didn’t even know you had. 


© hashCode() 


Cat c = new Cat (); 
System. out .printin (c.hashCode () ) ; 


File Edit Window Help Drop 


À hashtode 

rin out a 

Woa ae fa the obiett (Lor now) 
think of i as a unique 


8202111 ID). 


% java TestObject WPG he if two objects are 


@ toString() 


Cat c = new Cat (); 
System.out .printin(c.toString() ); 


File Edit Window Help LapselntoComa 


% java TestObject 


Cat@7d277£ 


ith 
À String message Wi 
prag the class and some 
er number we rarely Care 


about. 
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Object and abstract classes 


there, are_no 


Dumb Questions 


Q: Is class Object abstract? 


A: No. Well, not in the formal 
Java sense anyway. Object is a 
non-abstract class because it’s 
got method implementation 
code that all classes can inherit 
and use out of the box, without 
having to override the methods. 


: Then can you override 
the methods in Object? 


A: Some of them. But some of 
them are marked final, which 
means you can’t override them. 
You're encouraged (strongly) to 
override hashCode(), equals(), 
and toString() in your own 
classes, and you'll learn how to 
do that a little later in the book. 
But some of the methods, like 
getClass(), do things that must 
work in a specific, guaranteed 
way. 


212 chapter 8 


Q: HOW can you let 
somebody make an Object 


object? Isn't that just as weird 
as making an Animal object? 


A: Good question! Why is 

it acceptable to make a new 
Object instance? Because 
sometimes you just want a 
generic object to use as, well, as 
an object. A lightweight object. 
For now, just stick that on the 
back burner and assume that 
you will rarely make objects of 
type Object, even though you 
can. 


Q: So is it fair to say that the 
main purpose for type Object 

is so that you can use it fora 
polymorphic argument and 
return type? 


A: The Object class serves 
two main purposes: to act as a 
polymorphic type for methods 
that need to work on any class 
that you or anyone else makes, 
and to provide real method code 
that all objects in Java need at 
runtime (and putting them in 
class Object means all other 
classes inherit them). Some of 
the most important methods in 
Object are related to threads, 
and we'll see those later in the 
book. 


Q: If it’s so good to use 
polymorphic types, why 
don’t you just make ALL your 
methods take and return type 
Object? 


A: Ahbhh...think about what 
would happen. For one thing, 
you would defeat the whole 
point of “type-safety,” one 

of Java's greatest protection 
mechanisms for your code. With 
type-safety, Java guarantees that 
you won't ask the wrong object 
to do something you meant to 
ask of another object type. Like, 
ask a Ferrari (which you think is a 
Toaster) to cook itself. 

But the truth is, you don’t have 
to worry about that fiery Ferrari 
scenario, even if you do use 
Object references for everything. 
Because when objects are 
referred to by an Object 
reference type, Java thinks it’s 
referring to an instance of type 
Object. And that means the 
only methods you're allowed to 
call on that object are the ones 
declared in class Object! So if 
you were to say: 


Object o = new Ferrari (); 
o.goFast(); //Not legal! 


You wouldn't even make it past 
the compiler. 


Because Java is a strongly typed 
language, the compiler checks 
to make sure that you're calling 
a method on an object that’s 
actually capable of responding. 
In other words, you can calla 
method on an object reference 
only if the class of the reference 
type actually has the method. 
We'll cover this in much greater 
detail a little later, so don’t worry 
if the picture isn’t crystal clear. 


interfaces and polymorphism 


Using polymorphic references of type Object has a price... 


Before you run off and start using type Object for all your ultra-flexible argument and return types, 
you need to consider a little issue of using type Object as a reference. And keep in mind that we’re not 
talking about making instances of type Object; we’re talking about making instances of some other 
type, but using a reference of type Object. 
When you put an object into an ArrayList<Dog>, it goes in as a Dog and comes out as a Dog: 
Make an ArrayList de- k 

ArrayList<Dog> myDogArrayList = new ArrayList<Dog>() ; < ilared to hold Dog objects. 
Dog aDog = new Dog (); <— ane Dog to the list f : 

` Add the o9 eunt : Do re erence vari- 
a Assign the Do {rom the list to a new 09 


hod declares a Dog 
j i ; e PoR O though the get) met 
Dog d = myDogArrayList.get (0); €— teed aie Ja a PA 


myDogArrayList.add (aDog 


But what happens when you declare it as ArrayList<Object>? If you want to make an ArrayList that 


will literally take any kind of Object, you declare it like this: 

l l B Make an ArrayList declared 
g to hold any type of Object: 
ArrayList<Object> myDogArrayList = new ArrayList<Object>(); & 


Dog aDog = new Dog(); <— Make a Dog a two steps are the same as the 


myDogArrayList.add(aDog); @e—Add the Dog to the list. \ last example.) 


But what happens when you try to get the Dog object and assign it to a Dog reference? 


No! l Won't compile! l When you use ArrayList<Objeet>, the gett) method 


Dog (E P/mPogarrayList get (0); ting type Object. The ane knows only that the object inherits from 
Object (somewhere in its inheritance tree) but it doesn't know it's a Dog! 


Everything comes out of an ArrayList<Object> as a reference of type Object, 
regardless of what the actual object is or what the reference type was when you added the 
object to the list. 


The objects go IN 
as SoccerBall, 
Fish, Guitar, and 
Car. 


Objects come out of 
an ArrayList<Object> 
acting like they’re 
generic instances 


of class Object. The 
ArrayList<Object> Compiler cannot 
assume the object 
that comes out is of 
any type other than 


Object. 


But they come 
OUT as though 


they were of type 
Object. 
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When a Dog loses its Dogness 


When a Dog wont act like a Dog 


The problem with having everything treated © 
polymorphically as an Object is that the objects 
appear to lose (but not permanently) their true 

essence. The Dog appears to lose its dogness. Let’s see 
what happens when we pass a Dog to a method 
that returns a reference to the same Dog object, 


but declares the return type as type Object rather 
than Dog. 


I don't know what you're 
talking about. Sit? Stay? 

bark? Hmmmm...I don't 
recall knowing those. 


ethod 
; ; : \l Even though on the 
public void go() { This ime w he very sam Ob au 
Dog aDog = new Dog(); Larned a eren ‘ return tyr fe veturned 
BAD Dog sameDog = getObject (aDog) ; a si ent vekerved t let you assign 
® } ka the comriler won 4 0b) et 
\ M ferente ko anything meee 
rexer 
public Object getObject (Object o} { 


return o; 


e Do but as a return 
i We've oe a referente to the sam Y% 


: this is 
i i 4 is perfectly legal. Note 
* or af a fae gel method works when sre an 
T oLD vjet rather than an ArvayList<Doo>- 


eee ae The compiler doesn’t know that the 
DogPolyTest.java:10: incompatible types thing returned Irom the method i 
found : java.lang.Object actually a Doo, so it won t let you 
required: Dog assign it to a Dog referente. (You'll 
see why on the next page) 


Dog sameDog = getObject (aDog); 
1 error x 


public void go() 4 This works although it may not be very use— 


Dog aDog = new Dog(); ful, as you'll see ina moment) because You can 
400D Object sameDog = getObject (aDog) ; ie assign ANYTHING toa referente of ty e 
© } Object, since every class passes the ich test 
or Object. Every object in Java is an instance 
public Object getObject (Object o) { A ti Object, because every elass in Java has 
aao jett at the top of its inheritance tree. 


} 
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Objects dont bark 


So now we know that when an object is 
referenced by a variable declared as type 
Object, it can’t be assigned to a variable 
declared with the actual object’s type. And 
we know that this can happen when a return 
type or argument is declared as type Object, 
as would be the case, for example, when the 
object is put into an ArrayList of type Object 
using ArrayList<Object>. But what are the 
implications of this? Is it a problem to have 
to use an Object reference variable to refer to 
a Dog object? Let’s try to call Dog methods 
on our Dog-That-Compiler-Thinks-Is-An- 
Object: 


Object o = 


int i = o.hashCode(); £— ekhod on AN 


al.get (index) ; 


interfaces and polymorphism 


D, s eck 
Object 29 bY 


When you get an object referente from 
an ArrayList<Object> (or any method 
that declares Object as the return type), 
it Comes back as a polymorphic reference 
type of Object. So you have an Object 
reference to (in this case) a Dog instante. 


hash- 
Class object w 


Won t compile! —> CFRTEO; Can't do this!! The Object class has no idea what 


The compiler decides whether 
you can call a method based 


on the reference type, not the 
actual object type. 


Even if you know the object is capable (“...but 
it really ts a Dog, honest...”), the compiler 
sees it only as a generic Object. For all the 
compiler knows, you put a Button object 

out there. Or a Microwave object. Or some 
other thing that really doesn’t know how to 
bark. 

The compiler checks the class of the reference 
type—not the object type—to see if you can 
call a method using that reference. 


it means to bark). Even though YOU know it’s 
really a Dog at that index, the compiler doesn't. 


hashCode ) 


Object 


The method you're calling on a 


equals() referente MUST be in the class of 
getClass() that reference type. Doesn't matter 
hashCode() 


what the actual object is. 
toString() 


o.hashCode () ; 


The “o” veference was declared as ope 
Object, so You Can tall methods only i 
those methods are in class Object. 
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objects are Objects 


He treats 


Object 


equals() 
getClass() 

hashCode() 
toString() 


Snowboard 


Snowboard inherits methods 
from superclass Object and 


equals( adds four more. 


getClass() 
hashCode() 
toString() 


turn() 
shred() 
getAir() 
loseControl() 
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me like 


an Object. But I can do so 
much more...if only he'd see 
me for what I really am. 


Get in touch with your inner Object 


An object contains everything it inherits from each of its 
superclasses. That means every object—regardless of its actual 
class type—is also an instance of class Object. That means 
any object in Java can be treated not just as a Dog, Button, 

or Snowboard, but also as an Object. When you say new 
Snowboard (), you get a single object on the heap—a 
Snowboard object—but that Snowboard wraps itself around 
an inner core representing the Object (capital “O”) portion of 
itself. 


A single object 
on the eat. 


Snowboard 


S Coy 
wboard o9) 


There is only ONE object on the heap here. A Snowboard object. 
But it contains both the Snowboard elass parts of itself and the 
Object class parts of itself. 


Polymorphism means 
“many forms.” 


You can treat a Snowboard as a 
Snowboard or as an Object. 


interfaces and polymorphism 


When you put 

an object in an 
ArrayList<Object>, you 
can treat it only as an 


Object, regardless of 
the type it was when 
you put it in. 


If a reference is like a remote control, the remote 
control takes on more and more buttons as you 
move down the inheritance tree. A remote control 
(reference) of type Object has only a few buttons— 
the buttons for the exposed methods of class Object. 
But a remote control of type Snowboard includes all 
the buttons from class Object, plus any new buttons 
(for new methods) of class Snowboard. The more 
specific the class, the more buttons it may have. 


When you get a 
reference from an 
ArrayList<Object>, the 
reference is always of 
type Object. 


Of course that’s not always true; a subclass might 


That means you get an 
Object remote control. 


not add any new methods, but simply override the 
methods of its superclass. ‘The key point is that even 
if the object is of type Snowboard, an Object reference 
to the Snowboard object can’t see the Snowboard- 
specific methods. 


Snowboard S_= new Snowboard(); 


Object O = s; 


The Snowboard remote control (vefer— 

ence) has more buttons than an Object 

remote control. The Snowboard remote 

can see the full Snowboardness of the Oo 

Snowboard object. lt ean access all the 

methods in Snowboard, in¢luding both The Object referente can see only the 

the inherited Object methods and the Object parts of the Snowboard o ject. It 

methods from class Snowboard. tan access only the methods of elass Object. 
It has fewer buttons than the Snowboard 


remote control. 


fewer methods here... 


K 


you are here» 217 


casting objects 


Wait a minute...what good 
is a Dog if it comes out of an 

ArrayList<Object> and it can't do 
any Dog things? There's gotta be a 


Casting an object reference 
back to its real type. 


way to get the Dog back to a state 
of Dogness... 


GN 
og obt 
Object 


I hope it doesn't hurt. And 
what's so wrong with staying 

an Object? OK, I can't fetch, 
sure, but I can give you a real 
nice hashcode. 


new Dog reference to call Dog methods. 


Object o = al.get (index); 
Dog d = (Dog) 074 past the Obje : 
d.roam(); a Dog we know 


Cast the so—ealled ‘Object’ (but 
we know he’s actually a Dog) to 
type Des so that you ĉan best 
him like the Dog he really is. Dog 


It’s really still a Dog object, but if you want to call Dog- 
specific methods, you need a reference declared as type 
Dog. If you’re sure* the object is really a Dog, you can 
make a new Dog reference to it by copying the Object 
reference, and forcing that copy to go into a Dog 
reference variable, using a cast (Dog). You can use the 


tt back to 
s there- 


*If you're not sure it's a Dog, you can use the instanceof 
operator to check. Because if you're wrong when you do the 
cast, you'll get a ClassCastException at runtime and come to a 


grinding halt. 


if (o instanceof Dog) { 
Dog d = (Dog) o; 
} 
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interfaces and polymorphism 


So now you’ve seen how much Java 
cares about the methods in the 
class of the reference variable. 

qua ee Eee 


You can call a method on an object only if 
the class of the reference variable has that 
method. 


Think of the public methods in your class as 
your contract, your promise to the outside 
world about the things you can do. 


When you write a class, you almost always expose some of the 
methods to code outside the class. To expose a method means 
you make a method accessible, usually by marking it public. 


Imagine this scenario: you’re writing code for a small business 
accounting program. A custom application for Simon’s Surf 
Shop. The good re-user that you are, you found an Account 
class that appears to meet your needs perfectly, Account 
according to its documentation, anyway. Each 


account instance represents an individual debit(double amt) 
customer’s account with the store. So there you 
are minding your own business invoking the credit{double amt) 
credit() and debit(/) methods on an Account object 


f double getBal 
when you realize you need to get a balance on RERNE 


an account. No problem—there’s a getBalance() 
method that should do nicely. 


Except...when you invoke the getBalance() method, the whole 
thing blows up at runtime. Forget the documentation, the 
class does not have that method. Yikes! 


But that won’t happen to you, because every time you use the 
dot operator on a reference (a.doStuff()), the compiler looks at 
the reference type (the type “a” was declared to be) and checks 
that class to guarantee the class has the method, and that the 
method does indeed take the argument you’re passing and 


return the kind of value you’re expecting to get back. 


Just remember that the compiler checks the class 
of the reference variable, not the class of the actual 
object at the other end of the reference. 
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modifying a class tree 


What if you need to change 
the contract? 


OK, pretend you’re a Dog. Your Dog class 
isn’t the only contract that defines who you 
are. Remember, you inherit accessible (which 
usually means public) methods from all of your 
superclasses. 


True, your Dog class defines a contract. 
But not all of your contract. 


Everything in class Canine is part of your 
contract. 


Everything in class Animal is part of your 
contract. 


Everything in class Object is part of your 
contract. 


According to the IS-A test, you are each of those 
things—Canine, Animal, and Object. 


But what if the person who designed your class 
had in mind the Animal simulation program, and 
now he wants to use you (class Dog) for a Science 
Fair Tutorial on Animal objects. 


That’s OK, you’re probably reusable for that. 


But what if later he wants to use you for a Pet- 
Shop program? You don’t have any Pet behaviors. A 
Pet needs methods like beFriendly() and play(). 


OK, now pretend you’re the Dog class 
programmer. No problem, right? Just add some 
more methods to the Dog class. You won’t be 
breaking anyone else’s code by adding methods, 
since you aren’t touching the existing methods 
that someone else’s code might be calling on Dog 
objects. 


Can you see any drawbacks to that approach 
(adding Pet methods to the Dog class)? 
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OER AUN 
POWER 


Think about what YOU would do if YOU were the 


Dog class programmer and needed to modify the 


Dog so that it could do Pet things, too. We know 
that simply adding new Pet behaviors (methods) 
to the Dog class will work, and won't break anyone 
else's code. 


But...this is a PetShop program. It has more than 
just Dogs! And what if someone wants to use your 
Dog class for a program that has wild Dogs? What 
do you think your options might be, and without 
worrying about how Java handles things, just try 
to imagine how you'd like to solve the problem of 
modifying some of your Animal classes to include 
Pet behaviors. 


Stop right now and think about it, before you 
look at the next page where we begin to reveal 


everything.* 


*(Thus rendering the whole exercise completely useless, robbing 


you of your One Big Chance to burn some brain calories.) 


interfaces and polymorphism 


Let’s explore some design options 
for reusing some of our existing 
classes in a PetShop program 


On the next few pages, we’re going to walk through 
some possibilities. We’re not yet worried about whether 
Java can actually do what we come up with. We’ll cross 
that bridge once we have a good idea of some of the 
trade-offs. 


@) Option one 
We take the easy path and put pet 
methods in class Animal. 


Pros: 


All the Animals will instantly inherit 
the pet behaviors. We won't have to 
touch the existing Animal subclasses 
at all, and any Animal subclasses Animal 

created in the future will also get to 

take advantage of inheriting those 

methods. That way, class Animal can 

be used as the polymorphic type in 

any program that wants to treat the 

Animals as pets. Canine 


Cons: 


So...when was the last time you saw 
a Hippo at a pet shop? Lion? Wolf? 
Could be dangerous to give non- 
pets pet methods. 


Also, we almost certainly WILL 
have to touch the pet classes 
like Dog and Cat, because (in 
our house, anyway) Dogs 

and Cats tend to imple- 

ment pet behaviors 

VERY differently. 
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modifying existing classes 


®© Option two 
We start with Option One, putting the pet methods 
in class Animal, but we make the methods abstract, 
forcing the Animal subclasses to override them. 


Pros: 


That would give us all the benefits of option one, but with- 
out the drawback of having non-pet Animals running around 
with pet methods (like beFriendly()). All Animal classes 
would have the method (because it's in class Animal), but 
because it's abstract, the non-pet Animal classes won't 
inherit any functionality. All classes MUST override the 
methods, but they can make the methods “do-nothings.” 


Cons: 


Because the pet methods in the Animal class are all 

abstract, the concrete Animal subclasses are forced to 
implement all of them. (Remember, all abstract methods 
MUST be implemented by the first concrete subclass 

down the inheritance tree.) What a waste of time! 

You have to sit there and type in each and every 

pet method into each and every concrete non- 

pet class, and all future subclasses as well. 

And while this does solve the problem of "Feline | 
non-pets actually DOING pet things 

(as they would if they inherited pet 
functionality from class Animal), the 
contract is bad. Every non-pet 

class would be announcing to the 
world that it, too, has those 

pet methods, even though 

the methods wouldn't 

actually DO anything 

when called. 


This approach doesn't 

look good at all. It just = ag : Ask me to be friendly. 
seems wrong to stuff No, seriously... ask me. 
everything into class Animal I have the method. 
that more than one Animal type 

might need, UNLESS it applies to 

ALL Animal subclasses. 
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interfaces and polymorphism 


@) Option three 
Put the pet methods ONLY in the 
classes where they belong. 


Pros: 


No more worries about Hippos greeting you at the 

door or licking your face. The methods are where 

they belong, and ONLY where they belong. Dogs can 

implement the methods and Cats can implement the ONLY in the 
methods, but nobody else has to know about them. “4 Put the Pe et mer L can be Ye 


sses 
hia e ela Arim al. 


Cons: instead of 


Two Big Problems with this approach. First off, you'd 
have to agree to a protocol, and all programmers of 
pet Animal classes now and in the future would have z 
to KNOW about the protocol. By protocol, we mean Animal 

the exact methods that we've decided all pets should 

have. The pet contract without anything to back it up. 

But what if one of the programmers gets it just a tiny 

bit wrong? Like, a method takes a String when it was 

supposed to take an int? Or they named it doFriendly() 

instead of beFriendly()? Since it isn't in a contract, Canine 
the compiler has no way to check you to see if you've 
implemented the methods correctly. Someone 
could easily come along to use the pet Animal 
classes and find that not all of them work 
quite right. 


Feline 


And second, you don't get to use 
polymorphism for the pet methods. 
Every class that needs to use 
pet behaviors would have to 
know about each and every 
class! In other words, 

you can't use Animal 

as the polymorphic 

type now, because the 
compiler won't let you call 

a Pet method on an Animal 
reference (even if it's really a 
Dog object) because class Animal 
doesn't have the method. 
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multiple inheritance? 


So what we REALLY need is: 


« Away to have pet behavior in just the pet classes 


« Away to guarantee that all pet classes have all of the same 
methods defined (same name, same arguments, same return 
types, no missing methods, etc.), without having to cross your 
fingers and hope all the programmers get it right 


& Away to take advantage of polymorphism so that all pets can have 
their pet methods called, without having to use arguments, return 
types, and arrays for each and every pet class 


It looks like we need TWO 
superclasses at the top. 


sate mð owe 
ye 3 
We w? 


ave 
s ied pa ED 
ast 0 get Il Z 


Animal 


The non—pet Animals don +t 
have any inherited Pet 


stuff. 
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There’s just one problem with the “two superclasses” approach... 


interfaces and polymorphism 


It’s called “multiple inheritance,” 
and it can be a Really Bad Thing. 


That is, if it were possible to do in Java. 


But it isn't, because multiple inheritance has a problem 


bo 
er 
DBuener and aa 

C vk Xrom Digtal ey hod. 
ya vide ne DM E a vate" 
ve t the “ instan 
inher! 


sable: 


known as The Deadly Diamond of Death. 


Deadly Diamond of Death 


DigitalRecorder 


A both 
Both 


CDBurner 


DVDBurner 


ComboDrive 


with 
Which burn() 
urnl) on the 


variable ìs 


- 


KA stant 


eid inheritance 


e Comb boDrin Ws You call 


A language that allows the Deadly Diamond of Death can lead to 
some ugly complexities, because you have to have special rules to deal 
with the potential ambiguities. And extra rules means extra work for 


you both in learning those rules and watching out for those “special 
cases.” Java is supposed to be simple, with consistent rules that don’t 
blow up under some scenarios. So Java (unlike C++) protects you from 
having to think about the Deadly Diamond of Death. But that brings 
us back to the original problem! How do we handle the Animal/Pet thing? 
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interfaces 


Interface to the rescue! 


Java gives you a solution. An interface. Not a GUI interface, not the generic use of 
the word interface as in, “That’s the public interface for the Button class API,” but 
the Java keyword interface. 


A Java interface solves your multiple inheritance problem by giving you much of 
the polymorphic benefits of multiple inheritance without the pain and suffering 
from the Deadly Diamond of Death (DDD). 


The way in which interfaces side-step the DDD is surprisingly simple: make all 
the methods abstract! That way, the subclass must implement the methods 
(remember, abstract methods must be implemented by the first concrete subclass), 
so at runtime the JVM isn’t confused about which of the two inherited versions it’s 
supposed to call. 


A Java interface is like a 
100% pure abstract class. 


x Fri ly); e are 
abstract void beFriendly() ‘i csethods in mi inter otf a IS cA Pet 
abstract void play(); abstract $0 o am L te ee) the 
em ‘ 
vic im? 
methods e 


To DEFINE an interface: 


public interface Pet {...} 


Use th 
aF of * we len interface” 


To IMPLEMENT an interface: 


public class Dog extends Canine implements Pet {... 


à“ Snt Lollowed by 


Sme. Note that when yon 


Use the keywor 
terfate, You still get 


the interkace n 
implement an in 
; pee a elass- 
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Making and implementing 


the Pet interface 


Interface meth 


ods are i Im plicit} 


interfaces and polymorphism 


abstract, so typi Y Publie and 
ni » « 
7 face” 4 op tional (in M , be nb 5 Piee abstract” 
You say faa ge” here: sy ype the words in but, es Jood 
m „stead d of tla J rein orle it). ) we did here x i 
ds ave abstra™ 
public interface Pet { All terate mens in semicolons 
the Mu ody 
—_S SSS , , so the ey have no 
public abstract void beFriendly (); Remem e 
public abstract void play (); 
} — 
sa “implements” 
Don IS-A Animal ee 


and Dog Is-A Per 


y followed bY the name 
of the interface: 


public class Dog extends Canine implements Pet { 


public void beFriendly () 


public void play() {..} 


public void roam() {...} 


public void eat() {. 


there, are no 
nb Questions 


: Waita minute, interfaces 
don’t really give you multiple 
inheritance, because you can’t put 
any implementation code in them. 
If all the methods are abstract, what 
does an interface really buy you? 


A: Well, actually...there are 
cases where interfaces can have 


implementation code (static and 
default methods, for example), but 
we're not going to go into them here. 


The main purpose of interfaces 

is polymorphism, polymorphism, 
polymorphism. Interfaces are the 
ultimate in flexibility, because if you 
use interfaces instead of concrete 
classes (or even abstract classes) as 
arguments and return types, you can 
pass anything that implements that 
interface. And with an interface, a class 
doesn’t have to come from just one 
inheritance tree. A class can extend 
one class, and implement an interface. 
But another class might implement 
the same interface, yet come from a 
completely different inheritance tree! 


‘No 
.} Oe These are Just normal 


overriding eth 


So you get to treat an object by the role 
it plays, rather than by the class type 
from which it was instantiated. 


In fact, if you write your code using 
interfaces, you don't even have to give 
anyone a superclass to extend. You can 
just give them the interface and say, 
“Here, | don’t care what kind of class 
inheritance structure you come from, 
just implement this interface and you'll 
be good to go.” 
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interface polymorphism 


Classes from different inheritance trees 
can implement the same interface. 


Robot 


Pet 


oN f 


- RoboDog 


Animal 


When you use a class as a polymorphic type (like an 

array of type Animal or a method that takes a Canine 
argument), the objects you can stick in that type must be 
from the same inheritance tree. But not just anywhere in 
the inheritance tree; the objects must be from a class that 1s 
a subclass of the polymorphic type. An argument of type 
Canine can accept a Wolf and a Dog, but not a Cat or a 
Hippo. 


But when you use an interface as a polymorphic type 
(like an array of Pets), the objects can be from anywhere 

in the inheritance tree. The only requirement is that 

the objects are from a class that implements the interface. 
Allowing classes in different inheritance trees to implement 
a common interface 1s crucial in the Java API. Do 

you want an object to be able to save its state to a file? 
Implement the Serializable interface. Do you need objects 
to run their methods in a separate thread of execution? 


228 chapter 8 


Implement Runnable. You get the idea. You'll learn 

more about Serializable and Runnable in later chapters, 
but for now, remember that classes from any place in the 
inheritance tree might need to implement those interfaces. 
Nearly any class might want to be saveable or runnable. 


Better still, a class can implement 
multiple interfaces! 


A Dog object IS-A Canine, and IS-A Animal, and IS-A 
Object, all through inheritance. But a Dog IS-A Pet 
through interface implementation, and the Dog might 
implement other interfaces as well. You could say: 


public class Dog extends Animal implements 
Pet, Saveable, Paintable { ... } 


interfaces and polymorphism 


How do you know whether to make a 
class, a subclass, an abstract class, or 
an interface? 


m Make a class that doesn't extend anything 
(other than Object) when your new class doesn't 
pass the IS-A test for any other type. 


m Make a subclass (in other words, extend a class) 
only when you need to make a more specific 
version of a class and need to override or add 
new behaviors. 


m Use an abstract class when you want to define 
a template for a group of subclasses, and you 
have at least some implementation code that all 
subclasses could use. Make the class abstract 
when you want to guarantee that nobody can 
make objects of that type. 


m Use an interface when you want to define a role 
that other classes can play, regardless of where 
those classes are in the inheritance tree. 
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using super 


Invoking the superclass version of a method erson Mt 
i por m 


there, are_no 


Dumb Questions 


Q: What if you make a concrete subclass 
and you need to override a method, but you 


want the behavior in the superclass version of 
the method? In other words, what if you don’t 


need to replace the method with an override, 
but you just want to add to it with some 
additional specific code. 


abstract class Report { 
void runReport() { 
// set up report 
} 
void printReport() { 
// generic printing 


} 


class BuzzwordsReport extends Report { 


SiON) 
void runReport() { tall super class a 


super. runReport () ; then tome back = 
A: buzzwordCompliance () ; do some subclass 
« Ahhh...think about the meaning of the printReport () ; euie uct 
word extends. One area of good OO design looks } s 
at how to design concrete code that’s meant to 
be overridden. In other words, you write method void buzzwordCompliance() {...} 
code in, say, an abstract class, that does work } 
that’s generic enough to support typical concrete 
implementations. But, the concrete code isn’t 
enough to handle all of the subclass-specific 
work. So the subclass overrides the method 
and extends it by adding the rest of the code. 
The keyword super lets you invoke a superclass ( evides the 
version of an overridden method, from within the lass method owe 
subclass. pan version) 
If method code inside a al 
BuzzwordReport subclass says: 
7 runReport() 
super .runReport () ; buzzwordCompliance() WÀ superelass methods, 
_ intludind the overridden 
the vunReport() method inside the 
superclass Report will run y runReport() % tunRepor 
printReport() 
Report 
super.runReport(); 


BuzzwordReport 


À referente to the subclass object 
(BuzzwordReport) will always éall the 


subelass version of an overridden method. 


That’s polymorphism. But the subclass 
tode can call super-runReport() to invoke 


the superclass version. 
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The super keyword is really a referente to the 
superclass portion of an object. When subclass 
code uses super, as in super-runReport(), the 
superclass version of the method will run. 


BULLET POINTS 


When you don’t want a class to be instantiated (in other words, you don’t 
want anyone to make a new object of that class type), mark the class with the 
abstract keyword. 


An abstract class can have both abstract and non-abstract methods. 
If a class has even one abstract method, the class must be marked abstract. 


An abstract method has no body, and the declaration ends with a semicolon (no 
curly braces). 


All abstract methods must be implemented in the first concrete subclass in the 
inheritance tree. 


Every class in Java is either a direct or indirect subclass of class Object (java.lang. 
Object). 


Methods can be declared with Object arguments and/or return types. 


You can call methods on an object only if the methods are in the class (or interface) 
used as the reference variable type, regardless of the actual object type. So, a 
reference variable of type Object can be used only to call methods defined in class 
Object, regardless of the type of the object to which the reference refers. 


When a method is invoked, it will use the object type's implementation of that 
method. 


A reference variable of type Object can’t be assigned to any other reference type 
without a cast. A cast can be used to assign a reference variable of one type to a 
reference variable of a subtype, but at runtime the cast will fail if the object on the 
heap is NOT of a type compatible with the cast. 

Example: Dog d = (Dog) x.getObJject (aDog) ; 


All objects come out of an ArrayList<Object> as type Object (meaning, they can be 
referenced only by an Object reference variable, unless you use a cast). 


Multiple inheritance is not allowed in Java, because of the problems associated with 
the Deadly Diamond of Death. That means you can extend only one class (i.¢., you 
can have only one immediate superclass). 


Create an interface using the interface keyword instead of the word class. 


Implement an interface using the keyword implements. 
Example: Dog implements Pet 


Your class can implement multiple interfaces. 


Aclass that implements an interface must implement all the methods of the 
interface, except default and static methods (which we'll see in Chapter 12). 


To invoke the superclass version of a method from a subclass that’s overridden the 
method, use the super keyword. Example: super. runReport () ; 


interfaces and polymorphism 
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Dumb Questions 


Q: There’s still something 
strange here...you never 
explained how it is that 
ArrayList<Dog> gives back 
Dog references that don’t need 
to be cast. What’s the special 
trick going on when you say 
ArrayList<Dog>? 


A: You're right for calling it a 
special trick. In fact, it is a special 


trick that ArrayList<Dog> gives 
back Dogs without you having 

to do any cast, since it looks like 
ArrayList methods don't know 
anything about Dogs, or any type 
besides Object. 


The short answer is that the 
compiler puts in the cast for you! 
When you say ArrayList<Dog>, 
there is no special class that has 
methods to take and return Dog 
objects, but instead the <Dog> 

is a signal to the compiler that 
you want the compiler to let you 
put ONLY Dog objects in and to 
stop you if you try to add any 
other type to the list. And since 
the compiler stops you from 
adding anything but Dogs to the 
ArrayList, the compiler also knows 
that it’s safe to cast anything 

that comes out of that ArrayList 
to a Dog reference. In other 
words, using ArrayList<Dog> 
saves you from having to cast 
the Dog you get back. But it’s 
much more important than that... 
because remember, a cast can 
fail at runtime, and wouldn't you 
rather have your errors happen 
at compile time rather than, say, 
when your customer is using it for 
something critical? 


But there’s a lot more to this story, 
and we'll get into all the details in 
Chapter 11, Data Structures. 
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exercise: What’s the Picture? 


public 


public 


publ 


ic 


public 


public 


public 


public 


public 


public 


public 


publ 


publ 


pub] 


pub] 


pub] 


ic 
iC 
lic 
lic 


lic 


Here's your chance to demonstrate your artistic abilities. On the left you'll 
find sets of class and interface declarations. Your job is to draw the associated 
class diagrams on the right. We did the first one for you. Use a dashed line for 


“implements” and a solid line for “extends.” 


What's the Picture ? 
a 
interface) 
1. Foo 
interface Foo { } 
class Bar implements Foo { } 
2 AN 
interface Vinn { } 5 1 
eee a eee 
abstract class Vout implements Vinn { } Bar 
abstract class Muffie implements Whuffie { } 
class Fluffie extends Muffie { } 3 
interface Whuffie { } 
class Zoop { } 4 
class Boop extends Zoop { } 
class Goop extends Boop { } 
class Gamma extends Delta implements Epsilon { } 
interface Epsilon { } 
interface Beta { } 3. 
class Alpha extends Gamma implements Beta { } key 
T extends 
class Delta { } ja 
i implements 
Li 
Name f interface 
ame abstract class 


———> Answers on page 235. 
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interfaces and polymorphism 


On the left you'll find sets of class diagrams. Your job is to 
turn these into valid Java declarations. We did number 1 for 
you (and it was a tough one). 


What's the Declaration ? 


Given: 
Click 1. publie class Click { } 
l public class Clack extends Click { } 
Top 
2. 
2. 
Clack 
Tip 3 
Fee 
3, 
4. 
Foo 
4. 
Fi 
Bar 5, 
Zeta 
5. 
Baz 
Beta T 
Alpha -———— KEY 
T extends 
= n implements 
YN 
` Clack f class 
| Delta | 
Clack j interface 
— Answers on page 235. amar abstract class 
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puzzle: Pool Puzzle 


Your job is to take code snippets from the pool and 
place them into the blank lines in the code and out- 
put. You may use the same snippet more than once, 
and you won't need to use all the snippets. Your 
goal is to make a set of classes that will compile and 
run and produce the output listed. 


N 
aa public extends Clowns { 


} public static void main(String[] args) { 


abstract class Picasso implements { 
i[0] = new 


return 7; LEL = Rew 
} i[2] = new 
} for (int x = 0; x < 3; x++) { 


System. out.println ( 


class { } +"" 4 .getClass ()); 


} Output 


return 5; % java 
} 5 class Acts 
} 7 class Clowns 
Of76 


Note: Each snippet 
from the pool can be 
used more than once! 


class 
Acts(); extends 
Nose(); interface i() 


Of76(); implements jx) 
Clowns(); iix] class 
Picasso(); 5 class 
7 class ae 
. ublic int iMethod() ; 7 public class ose 
Of76 [] i = new Nose[3]; Babli int iMethod{ } Of76 
Of76 [3] i; public int iMethod\() { i.iMethod(x) Clowns 
Nose [] i = new Nose); public int iMethod() {} i(x).iMethod[] Picasso 


Nose [] i = new Nose[3]; i[x].iMethod() 


i[x].iMethod[] 
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gs Exercise Solutions 


What's the Picture ? (from page 232) 


a 
(Gnterface) 
Vinn 


aii 
Gnterface) 
WhuF fie 


ra 


Fluffie 


Zoop 


Boop 


oop 


A 
(interface) 
Delta Epsilon 
a 
(interface) 
Gamma Beta 


ws 


W RRM W 


A 


interfaces and polymorphism 


What’s the Declaration ? (from page 233) 


2, Publie abstract class Top { } 
publie class Tip extends Top { } 


3, Public abstract class Fee { } 
public abstract class Fi extends Fee { } 


4 publie interface Foo { } 
public class Bar implements Foo { } 
publie class Baz extends Bar { } 


5 public interface Zeta { } 
public class Alpha implements Zeta { } 
public interface Beta { } 
publie class Delta extends Alpha implements Beta { } 


key 


T extends 

oT. 

i implements 
L 

Name j class 


Name j interface 
Name j abstract class 
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puzzle solution 


QR 


Poo] Puzzle 


(from page 234) 


interface Nose { 
public int iMethod() ; 


abstract class Picasso implements Nose { 
public int iMethod() { 


return 7; 


class Clowns extends Picasso { } 


class Acts extends Picasso { 
public int iMethod() { 


return 5; 
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public class Of76 extends Clowns { 
public static void main(String[] args) 
Nose[] i = new Nose [3]; 
i[0] 


new Acts(); 


if] new Clowns(); 

if2] = new Of76(); 

for (int x = O; x < 3; x++) { 
System. out.print1n (i[x].iMethod() 


+" " + i[x].getClass()); 


Output 
Sjava Of76 


5 class Acts 


7 class Clowns 
7 class Of76 


9 constructors and garbage collection 


Life and Death 
of an Object 


... then he said, 
“I can't feel my legs 

and I said “Joe! Stay with me 

Joe!" But it was...too late. The garbage 


|" 


collector came and...he was gone. Best 
object I ever had. Gone. 


Objects are born and objects die. You're in charge of an object's lifecycle. 

You decide when and how to construct it. You decide when to destroy it. Except you don't 
actually destroy the object yourself, you simply abandon it. But once it’s abandoned, the 
heartless Garbage Collector (gc) can vaporize it, reclaiming the memory that object was 
using. If you're gonna write Java, you're gonna create objects. Sooner or later, you're gonna 
have to let some of them go, or risk running out of RAM. In this chapter we look at how objects 
are created, where they live while they're alive, and how to keep or abandon them efficiently. 
That means we'll talk about the heap, the stack, scope, constructors, superclass constructors, 
null references, and more. Warning: this chapter contains material about object death that 


some may find disturbing. Best not to get too attached. 
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the stack and the heap 


The Stack and the Heap: where things live 


Before we can understand what really happens when you 
create an object, we have to step back a bit. We need to 
learn more about where everything lives (and for how 
long) in Java. That means we need to learn more about 
two areas of memory—the Stack and the Heap. When 

a JVM starts up, it gets a chunk of memory from the 
underlying OS and uses it to run your Java program. 
How much memory, and whether or not you can tweak 

it, is dependent on which version of the JVM (and on 
which platform) you’re running, But usually you won’t have 
any say in the matter. And with good programming, you 
probably won’t care (more on that a little later). 


The Stack 


Where method invocations 
and local variables live 


Instance Variables 


Instance variables are declared inside a class but not 
inside a method. They represent the “fields” that each 
individual object has (which can be filled with different 
values for each instance of the class). Instance variables 
live inside the object they belong to. 


public class Duck { 


vek k has a “ize 
sable: 


int size; e Every P 
stan te var! 
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In Java, we (programmers) care about the area of memory 
where objects live (the heap) and the one where method 
invocations and local variables live (the stack). 


We know that all objects live on the garbage-collectible 
heap, but we haven’t yet looked at where variables live. And 
where a variable lives depends on what kind of variable 

it is. And by “kind,” we don’t mean ype (1.e., primitive or 
object reference). The two kinds of variables whose lives 
we care about now are instance variables and local variables. 
Local variables are also known as stack variables, which is a 
big clue for where they live. 


The Heap “The 
ee e eCo a yetkivle 


Where ALL objects live gabag 
a Wear 


Local Variables 


Local variables are declared inside a method, including 
method parameters. They're temporary and live only as 
long as the method is on the stack (in other words, as long as 
the method has not reached the closing curly brace). 


public void foo(int x) { 
int i = x + 3; 


boolean b 


true; 


Methods are stacked 


When you call a method, the method lands on the 
top of a call stack. That new thing that’s actually 
pushed onto the stack is the stack frame, and it 
holds the state of the method including which line 
of code is executing, and the values of all local 
variables. 


The method at the top of the stack is always the 
currently running method for that stack (for now, 
assume there’s only one stack, but in Chapter 14, A 
Very Graphic Story, we'll add more.) A method stays 
on the stack until the method hits its closing curly 
brace (which means the method’s done). If method 
foo() calls method bar(), method bar() is stacked on 
top of method foo(). 


public void doStuff() { 
boolean b = true; 
go(4); 

} 


A stack 


constructors and gc 


A call stack with two methods 


Top of the stack 
u— 


= Local variables 
a Cineluding 


A Parameter x) 
Bottom of the stack 


The method on the top of the 
stack is always the currently 
executing method. 


scenario 


The code on the left is a snippet (we don’t care what the rest of the class 


looks like) with three methods. The first method (doStuff()) calls the second 


public void go(int x) { 
int z x + 24; 
crazy (); 
// imagine more code here 


} 


public void crazy() { 
char c ‘al; 


} 


Code from another 
class calls doStuff(), 
and doStuff() goes 
into a stack frame at 
the top of the stack. 
The boolean variable 
named “b" goes on 
the doStuff() stack 
frame. 


@ 


and go() is pushed 


frame. 


doStuff() calls go(), 


on top of the stack. 
Variables “x” and “z" 
are in the go() stack 


method (go()), and the second method calls the third (crazy()). Each method 
declares one local variable within the body of the method (b, z, and c), and 
method go() also declares a parameter variable (which means go() has two 
local variables, x and 2). 


go() calls crazy(), © crazy() completes, 
crazy() is now on the and its stack frame is 
top of the stack, popped off the stack. 


with variable “c" in 
the frame. 


Execution goes back 
to the go() method 
and picks up at the 
line following the call 
to crazy(). 
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object references on the stack 


What about local variables that are objects? 


a 
Remember, a non-primitive variable holds a reference to an object, 

not the object itself. You already know where objects live—on the 

heap. It doesn’t matter where they’re declared or created. If the 

local variable is a reference to an object, only the 

variable (the reference/remote control) goes on the ate 
stack. 


public class StackRef { 
public void foof() { 
barf (); 


} Suck oe Year 


public void barf() { No matter 
- WHERE ; 
eee ae rele oie chet 
method vs. as an j vec inside a 


a élass), the aj aal nte variable of 


ahay goes on The heme” M85 


there, are_no 


Dumb Questions 


_— BULLET POINTS 


+ One more time, WHY are we learning the 
whole stack/heap thing? How does this help me? 


Do I really need to learn about it? a Java has two areas of memory we care about: 


the Stack and the Heap. 


a Instance variables are variables declared 


A: Knowing the fundamentals of the Java inside a class but outside any method. 


Stack and Heap is crucial if you want to understand : f S 
variable scope, object creation issues, memory a Local variables are variables declared inside a 
management, threads, and exception handling. method or method parameter. 

We cover threads and exception handling in later 
chapters. You do not need to know anything about 
how the Stack and Heap are implemented in any 
particular JVM and/or platform. Everything you 
need to know about the Stack and Heap is on this 


a All local variables live on the stack, in the 
frame corresponding to the method where the 
variables are declared. 


a Object reference variables work just like primi- 


page and the previous one. If you nail these pages, 
all the other topics that depend on your knowing 
this stuff will go much, much, much easier. Once 
again, some day you will SO thank us for shoving 
Stacks and Heaps down your throat. 
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tive variables—if the reference is declared as a 
local variable, it goes on the stack. 


a All objects live in the heap, regardless of 
whether the reference is a local or instance 
variable. 


If local variables live on the stack, 
where do instance variables live? 
SS ee 


When you say new CellPhone(), Java has to make space on 
the Heap for that CellPhone. But how much space? Enough 
for the object, which means enough to house all of the 
object’s instance variables. That’s right, instance variables 
live on the Heap, inside the object they belong to. 


Remember that the values of an object’s instance variables 
live inside the object. If the instance variables are all 
primitives, Java makes space for the instance variables 
based on the primitive type. An int needs 32 bits, a long 64 
bits, etc. Java doesn’t care about the value inside primitive 
variables; the bit-size of an int variable is the same (32 bits) 
whether the value of the int is 32,000,000 or 32. 


But what if the instance variables are objects? What if 
CellPhone HAS-A Antenna? In other words, CellPhone has 
a reference variable of type Antenna. 


When the new object has instance variables that are object 
references rather than primitives, the real question is: 
does the object need space for all of the objects it holds 
references to? The answer is, not exactly, No matter what, 
Java has to make space for the instance variable values. 
But remember that a reference variable value is not the 
whole object, but merely a remote control to the object. So 

if CellPhone has an instance variable declared as the 
non-primitive type Antenna, Java makes space within the 
CellPhone object only for the Antenna’s remote control (1.e., 
reference variable) but not the Antenna object. 


Well, then, when does the Antenna object get space on the 
Heap? First we have to find out when the Antenna object 
itself is created. That depends on the instance variable 
declaration. If the instance variable is declared but no 
object is assigned to it, then only the space for the reference 
variable (the remote control) is created. 


private Antenna ant; 


No actual Antenna object is made on the heap unless or 
until the reference variable is assigned a new Antenna 
object. 


private Antenna ant = new Antenna(); 
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CellPhone object 


TAY, 


int long 


Object with two primitive instance variables. 
Space for the variables lives in the object. 


CellPhone object 


Object with one non—primitive instance variable— 
a reference to an Antenna object, but no actual 
Antenna object. This is what you get if you 
declare the variable but don't initialize it with 
an actual Antenna object. 


public class CellPhone { 
private Antenna ant; 


} 


CellPhone object Antenna object 


Object with one non—Pprimitive instante vari—- 
able, and the Antenna variable is assigned a new 
Antenna object. 


public class CellPhone { 
private Antenna ant = new Antenna(); 


} 
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object creation 


The miracle of object creation 


Now that you know where variables and objects live, we can dive into the 
mysterious world of object creation. Remember the three steps of object 
declaration and assignment: declare a reference variable, create an object, 
and assign the object to the reference. 


But until now, step two—where a miracle occurs and the new object is 
“born”—has remained a Big Mystery. Prepare to learn the facts of object 
life. Hope you’re not squeamish. 


Let's review the 3 steps of object 
declaration, creation and assignment: 


Declare a reference 


variable 
a new cekerente 
Mar ok a class 9 Duck myDuck = new Duck (); 
\a e a 
pale ate Aye 
i) 


(2) Create an object 
wate i Duck myDuck = new Duck (); 
e here: Duck object 
o 
hesian the ne™ Link the object and 
pert to e the reference 
Terere Duck myDuck (=)new Duck () ; 


Duck object 


Duck reference 
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Are we calling a method named Duck()? 


Because it sure looks like it. ree calling ê 


ike we 
|£ locks W AYO 
~~ method raed Parentheses 


Duck myDuck = new Duck (); \etavs¢ 


No. 


We’re calling the Duck constructor. 


A constructor does look and feel a lot like a method, but it’s not a 
method. It’s got the code that runs when you say new. In other words, aconstructor has the 


the code that runs when you instantiate an object. code that runs when you 


The only way to invoke a constructor is with the keyword new instantiate an object. In 
followed by the class name. The JVM finds that class and invokes other words, the code that 


the constructor in that class. (OK, technically this isn’t the only way runs when you say new on 


a class type. 


to invoke a constructor. But it’s the only way to do it from outside a 
constructor. You can call a constructor from within another constructor, 
with restrictions, but we’ll get into all that later in the chapter.) 


Every class you write has 
a constructor, even if you 
But where is the constructor? don’t write it yourself. 


If we didn’t write it, who did? 


You can write a constructor for your class (we’re about to do that), 
but if you don’t, the compiler writes one for you! 


Here’s what the compiler’s default constructor looks like: 


public Duck() { 


} 
Notice something missing? How is this tre elass 
different from a method? ve the same 95 
\ts name 'S ) datery- 
e. Thats man 
nam 
Where’ public Duck() { 
rai the return type? If // constructor code goes here 
need a cia method you'd 
“publ nreturn type betwe 
it and Duek()” en 
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constructing a new Duck 


Construct a Duck If it Quacks like a 


The key feature of a constructor is that it runs before constructor... 


the object can be assigned to a reference. That 
means you get a chance to step in and do things to 
get the object ready for use. In other words, before 
anyone can use the remote control for an object, the 
object has a chance to help construct itself: In our 
Duck constructor, we’re not doing anything useful, 
just demonstrating the sequence of events. 


public class Duck { 


public Duck() { 


System. out .printin ("Quack"); . 
} The constructor gives 


} ma for tode- you a chance to step into 
-i the middle of new. 


% java UseADuck 


public class UseADuck { 


public static void main (String[] args) { Greek 
Duck d = new Duck(); 
} M~ This eals 4, 


} Constructo, ¢ Duck 


—-» Yours to solve. 


Increment a counter to track how many objects of this class type 
have been made. 


Assign runtime-specific state (data about what's happening NOW). 
Assign values to the object's important instance variables. 

Get and save a reference to the object that’s creating the new object. 
Add the object to an ArrayList. 

Create HAS-A objects. 


Ge sharpen your pencil 
ere your p 


A constructor lets you jump into the middle 


of the object creation step—into the middle 
of new. Can you imagine conditions where 
that would be useful? Which of the actions 
on the right might be useful in a Car class 


constructor, if the Car is part of a Racing 


(your idea here) 


Game? Check off the ones that you came up 
with a scenario for. 
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lnitializing the state of a new Duck 


Most people use constructors to initialize the state of an object. 
In other words, to make and assign values to the object’s instance 
variables. 


public Duck() { 
size = 34; 


} 


That’s all well and good when the Duck class developer knows how big 
the Duck object should be. But what if we want the programmer who 
is using Duck to decide how big a particular Duck should be? 


Imagine the Duck has a size instance variable, and you want the 
programmer using your Duck class to set the size of the new Duck. 
How could you do it? 


Well, you could add a setSize() setter method to the class. But that 
leaves the Duck temporarily without a size* and forces the Duck user 
to write two statements—one to create the Duck, and one to call the 
setSize() method. The code below uses a setter method to set the 
initial size of the new Duck. 


public class Duck { 


sable 
int size; « Instante variab 
public Duck() { 
7 
System. out .printl1n ("Quack"); Construtto 
} 
public void setSize(int newSize) { à 
size = newSize; _ Setter metho 


public class UseADuck { 


public static void main(String[] args) { 
Duck d = new Duck (); 


; b : 
d.setSize(42); ¢—_ " dlive at i. ee, here. The Duek 


0.0 for numeric primitives, false for booleans, and 
null for references. 
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thereareno  , 
Dumb Questions 


|? Why do you need to write a con- 
structor if the compiler writes one for you? 


A: If you need code to help initialize your 
object and get it ready for use, you'll have to 
write your own constructor. You might, for 
example, be dependent on input from the 
user before you can finish making the ob- 
ject ready. There’s another reason you might 
have to write a constructor, even if you 
don't need any constructor code yourself. It 
has to do with your superclass constructor, 
and we'll talk about that soon. 


+ How can you tell a constructor from 
a method? Can you also have a method 
that’s the same name as the class? 


A: Java lets you declare a method with 
the same name as your class. That doesn’t 
make it a constructor, though. The thing 
that separates a method from a construc- 
tor is the return type. Methods must have a 
return type, but constructors cannot have a 
return type. 


public Duck() { } Constructor 


public void Duck() { } Method 
T Return t pe 

The compiler will allow these methods but 

don’t do this. It's against normal naming 

conventions (methods start with a lower- 

case letter) but more importantly it's super 

confusing. 


: Are constructors inherited? If you 
don’t provide a constructor but your 
superclass does, do you get the superclass 
constructor instead of the default? 


Nope. Constructors are not inherited. 
We'll look at that in just a few pages. 
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initializing object state 


Using the constructor to initialize 
important Duck state* 


If an object shouldn’t be used until one or more 
parts of its state (instance variables) have been 
initialized, don’t let anyone get hold of a Duck 
object until you’re finished initializing! It’s usually 
way too risky to let someone make—and get a 
reference to—a new Duck object that isn’t quite 
ready for use until that someone turns around and 
calls the setSize() method. How will the Duck user 
even know that he’s required to call the setter method 
after making the new Duck? 


Let the user make a new Duck 
and set the Duck's size all in 
one call. The call to new. 
The call to the Duck 
constructor. 


The best place to put initialization code is in the 
constructor. And all you need to do is make a 


constructor with arguments. kp ne 
panet 
public class Duck { gn h X- 
int size; pod pou? 
’ a Dutt to 
public Duck(int duckSize) { tice the argument value to set the 
System.out.printin ("Quack") ; seemne variable. We tould 
ize method 
size = duckSize; a have talled the setSi 
instead. 
System.out.printliln("size is " + size); 
} 
} 


public class UseADuck { 


public static void main (String[] args) { 
—y Duck d = new Duck (42); 
jig ony } 


Pas 
. o Knee S a value to th 
; e e 
qe pan ae Constructor. 

s V 
er yhe new ze ore 
7 à get i 5 % java UseADuck 

\ Aà 

ent 
cae" Quack 


size is 42 


*Not to imply that not all Duck state is not unimportant. 
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Make it easy to make a Duck 


Be sure you have a no-arg constructor 


What happens if the Duck constructor takes an argument? Think 


about it. On the previous page, there’s only one Duck constructor—and 


it takes an int argument for the size of the Duck. That might not be a 
big problem, but it does make it harder for a programmer to create a 
new Duck object, especially if the programmer doesn’t know what the 
size of a Duck should be. Wouldn’t it be helpful to have a default size 
for a Duck so that if the user doesn’t know an appropriate size, they 
can still make a Duck that works? 


Imagine that you want Duck users to have TWO options 
for making a Duck—one where they supply the Duck 
size (as the constructor argument) and one where they 
don’t specify a size and thus get your default Duck size. 


You can’t do this cleanly with just a single constructor. Remember, 

if a method (or constructor—same rules) has a parameter, you must 
pass an appropriate argument when you invoke that method or 
constructor. You can’t just say, “If someone doesn’t pass anything to 
the constructor, then use the default size” because they won’t even be 
able to compile without sending an int argument to the constructor 
call. You could do something clunky like this: 


public class Duck { is 
int size; er value 


\f the "i w Du : p 
public Duck (int newSize) { zevo Ts ex wise” 
if (newSize == 0) { 4 7 deka n vave ar 
size = 27; the got a very 9 
} else { be S26 
size = newSize; sutor 
} 


} 


But that means the programmer making a new Duck object has to 
know that passing a “0” is the protocol for getting the default Duck 
size. Pretty ugly. What if the other programmer doesn’t know that? 
Or what if they really do want a zero-sized Duck? (Assuming a zero- 
sized Duck is allowed. If you don’t want zero-sized Duck objects, 
put validation code in the constructor to prevent it.) The point is, 

it might not always be possible to distinguish between a genuine “I 
want zero for the size” constructor argument and a “I’m sending 
zero so you'll give me the default size, whatever that is” constructor 
argument. 
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You really want TWO ways to 
make a new Duck: 


public class Duck2 { 
int size; 


public Duck2() { 
// supply default size 
size = 27; 


} 


public Duck2(int duckSize) { 
// use duckSize parameter 
size = duckSize; 


} 


To make a Duck when you know the size: 


Duck2 d = new Duck2 (15); 


To make a Duck when you do not know 
the size: 


Duck2 d2 = new Duck2(); 


So this two-options-to-make-a-Duck idea 
needs two constructors. One that takes 
an int and one that doesn't. If you have 
more than one constructor in a class, 

it means you have overloaded 
constructors. 
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overloaded and default constructors 


Doesn't the compiler always 
make a no-arg constructor 
for you? \o! 

a 


You might think that if you write only a 
constructor with arguments, the compiler 
will see that you don’t have a no-arg 
constructor and stick one in for you. But 
that’s not how it works. The compiler gets 
involved with constructor-making only if you 
don’t say anything at all about constructors. 


If you write a constructor that 
takes arguments and you still 
want a no-arg constructor, 
you'll have to build the no-arg 
constructor yourself! 


As soon as you provide a constructor, ANY 
kind of constructor, the compiler backs off 
and says, “OK fair enough, looks like you’re 


in charge of constructors now.” 


If you have more than one 
constructor in a class, the 
constructors MUST have 
different argument lists. 


The argument list includes the order and 
types of the arguments. As long as they’re 
different, you can have more than one 
constructor. You can do this with methods as 
well, but we’ll get to that in another chapter. 
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OK, let's see here... “You 
have the right to your own 
constructor.” Makes sense. 


“If you cannot afford a constructor, 
one will be provided for you by the 
compiler." Good to know. 


Overloaded constructors means you have 
———__—_——— a 
more than one constructor in your class. 


To compile, each constructor must have a 
different argument list! 


The class below is legal because all five constructors have different 
argument lists. If you had two constructors that took only an int, for 
example, the class wouldn’t compile. What you name the parameter 
variable doesn’t count. It’s the variable type (int, Dog, etc.) and order 
that matters. You can have two constructors that have identical 
types, as long as the order is different. A constructor that takes 
a String followed by an int is not the same as one that takes an int 
followed by a String, 
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Fie 
z ve differe, oy 
ans five diff. hstrueto. 

r 


make 
a he 
W mush 
roo, 


u know the size but you 


public class Mushroom { 


When 


— fede boon if it’s magit 


public Mushroom (int size) { } 


£ know anything 


leo When you don t 
public Mushroom( ) { } When you know if it s magit or not 
, i IL know he size 
public Mushroom (boolean isMagic) {} ®t don t kn 
A 7 : 7 When you know p 
These two Sy me public Mushroom(boolean isMagic, int size) { } helher no S 
aros, but m , , anes you kn 
sare vent order, 8° ( public Mushroom (int size, boolean isMagic) { } ne size as well 


it’s OK* j 


BULLET POINTS 


the compiler know they were two di 


*|f the arguments were the same ae how would 


erent things? 


a Instance variables live within the object they belong to, on 
the Heap. 


a |fthe instance variable is a reference to an object, both 
the reference and the object it refers to are on the Heap. 


= A constructor is the code that runs when you say new on 
a Class type. 


= A constructor must have the same name as the class, and 
must not have a return type. 


= You can use a constructor to initialize the state (i.e., the 
instance variables) of the object being constructed. 


a |f you don't put a constructor in your class, the compiler 
will put in a default constructor. 


a The default constructor is always a no-arg constructor. 


m lf you put a constructor—any constructor—in your class, 
the compiler will not build the default constructor. 


If you want a no-arg constructor and you've already put 
in a constructor with arguments, you'll have to build the 
no-arg constructor yourself. 


Always provide a no-arg constructor if you can, to make it 
easy for programmers to make a working object. Supply 
default values. 


Overloaded constructors means you have more than one 
constructor in your class. 


Overloaded constructors must have different argument 
lists. 


You cannot have two constructors with the same 
argument lists. An argument list includes the order and 
type of arguments. 


Instance variables are assigned a default value, even 
when you don’t explicitly assign one. The default values 
are 0/0.0/false for primitives, and null for references. 
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overloaded constructors 


G harpen your pencil 


that runs when that Duck is instantiated. We did 
the easy one to get you started. 


public class TestDuck { 


public static void main(String[] args) { 
int weight = 8; 
float density = 2.3F; 
String name = "Donald"; 
long[] feathers = {1, 2, 
boolean canFly = true; 
int airspeed = 22; 


3, 4, 5, 


Duck[] d = new Duck[7]; 
d[0] = new Duck(); 
a[1] = new Duck (density, weight); 
d[2] = new Duck (name, feathers); 
a[3] = new Duck (canF1ly) ; 
a[4] = new Duck(3.3F, airspeed); 
a[5] = new Duck (false); 
d[6] = new Duck (airspeed, density); 
} 
} 
therejare no 


Dumb Questions 


* Earlier you said that it's good to have a no-argument 
constructor so that if people call the no-arg constructor, we 
can supply default values for the “missing” arguments. But 
aren't there times when it’s impossible to come up with de- 
faults? Are there times when you should not have a no-arg 
constructor in your class? 


A: You're right. There are times when a no-arg construc- 
tor doesn’t make sense. You'll see this in the Java API—some 
classes don’t have a no-arg constructor. The Color class, for 
example, represents a...color. Color objects are used to, for 
example, set or change the color of a screen font or GUI 
button. When you make a Color instance, that instance is of 
a particular color (you know, Death-by-Chocolate Brown, 
Blue-Screen-of-Death Blue, Scandalous Red, etc.). 
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—-» Yours to solve. 


IN Match the new Duck () call with the constructor 


class Duck { 
private int kilos = 6; 
private float floatability = 2.1F; 
private String name = "Generic"; 
private long[] feathers = {1, 2, 
4, 5, 
boolean canFly = true; 
int maxSpeed = 25; 


7}; 
private 
private 


public Duck() { 
System.out.printin("type 1 duck"); 
} 


public Duck (boolean fly) { 
canFly = fly; 
System.out.printin("type 2 duck"); 
} 


public Duck (String n, 
name = n; 
feathers = f; 
System.out.printin("type 3 duck"); 
} 


long[] £) { 


public Duck(int w, float f) { 
kilos = w; 
floatability = f; 
System.out.printin("type 4 duck"); 
} 


public Duck (float density, int max) { 
floatability = density; 
maxSpeed = max; 
System.out.printlin("type 5 duck"); 
} 
} 


If you make a Color object, you must specify the color in 
some way. 

Color c = new Color (3,45,200) ; 
(We're using three ints for RGB values here. We'll get into 
using Color later, in Chapter 15, Work on Your Swing.) Other- 
wise, what would you get? The Java API programmers could 
have decided that if you call a no-arg Color constructor 
you'll get a lovely shade of mauve. But good taste prevailed. 
If you try to make a Color without supplying an argument: 


Color c = new Color(); 


File Edit Window Help StopBeingStupid 


cannot resolve symbol 
:constructor Color () 
location: class java.awt. 
Color 
Color c = 


the compiler freaks 
out because it can’t 
find a matching no-arg 
constructor in the 
Color class. 


new Color (); 
A 


1 error 


Nanoreview: four things to 
remember about constructors 


© A constructor is the code that runs when 


© 


*Doing all the Brain Power exercises has been shown to produce a 42% 
increase in neuron size. And you know what they say, “Big neurons...” 


somebody says new on a class type: 


Duck d = new Duck (); 
— 


A constructor must have the same name 
as the class, and no return type: 


public Duck(int size) { } 


D 


If you don't put a constructor in your class, 
the compiler puts in a default constructor. 
The default constructor is always a no-arg 
constructor. 


public Duck() { } 


You can have more than one constructor in your class, 
as long as the argument lists are different. Having 


more than one constructor in a class means you have 


overloaded constructors. 
AAA Mikelete Ae] 


public Duck() { } 
public Duck (int size) { } 


public Duck (String name) { } 


public Duck (String name, int size) 


{ 


} 
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jo RAIN 
PQwWwWwER 
What about superclasses? 


When you make a Dog, 
should the Canine 
constructor run too? 


If the superclass is abstract, 
should it even havea 
constructor? 


We'll look at this on the next 
few pages, so stop now and 
think about the implications of 
constructors and superclasses.* 


there, are no ô 
Dumb Questions 


| Do constructors have to be public? 


A: No. Constructors can be public, pro- 
tected, private, or default (which means 
no access modifier at all). We'll look more at 
default access in appendix B. 


: How could a private constructor 
ever be useful? Nobody could ever call it, 
so nobody could ever make a new object! 


A: Not exactly right. Marking something 
private doesn’t mean nobody can access 
it; it just means that nobody outside the class 
can access it. Bet you're thinking Catch 

22. Only code from the same class as the 
class-with-private-constructor can make a 
new object from that class, but without first 
making an object, how do you ever get to 
run code from that class in the first place? 
How do you ever get to anything in that 
class? Patience grasshopper. We'll get there 
in the next chapter. 
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space for an object’s superclass parts 


Wait a minute...we never DID talk about 
superclasses and inheritance and how that all 
fits in with constructors 


Here’s where it gets fun. Remember in the previous chapter we looked at the Snowboard object 
wrapping around an inner core representing the Object portion of the Snowboard class? The 
Big Point there was that every object holds not just its own declared instance variables, but also 
everything from us superclasses (which, at a minimum, means class Object, since every class extends 


Object). 


So when an object is created (because somebody said new; there is no other way to create an 
object other than someone, somewhere saying new on the class type), the object gets space for 


all the instance variables, from all the way up the inheritance tree. Think about it for a moment... 


a superclass might have setter methods encapsulating a private variable. But that variable has to 
live somewhere. When an object is created, it’s almost as though multiple objects materialize—the 
object being new’d and one object per each superclass. Conceptually, though, it’s much better to 
think of it like the picture below, where the object being created has layers of itself representing 
each superclass. 


Object has instance variables 
encapsulated by access meth- 
ods. Those instance variables 
are created when any subélass is 
instantiated. (These aren't the 
REAL Object variables, but we 
don't care what they are since 
they've encapsulated.) 


equals() 
getClass() 

hashCode() 
toString() 


A single 
objet on 
the heap 


Snowboard Snowboard also has instance 
Foo x variables of its own, so to make Snowboard 
Foo y a Snowboard object we need 4 
intz space for the instance variables Sho oie? 
wbhoard 

turn() of both classes. 

hred 
wa There is only ONE object on the heap here. A Snow- 
loseControl() board object. But it contains both the Snowboard 


parts of itself and the Object parts of itself. All 


instance variables from both classes have to be here. 
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The role of superclass constructors 


in an object's life 


All the constructors in an object’s 
inheritance tree must run when you 
make a new object. 


Let that sink in. 


That means every superclass has a constructor 
(because every class has a constructor), and each 
constructor up the hierarchy runs at the time an 
object of a subclass is created. 


Saying new is a Big Deal. It starts the whole 
constructor chain reaction. And yes, even 
abstract classes have constructors. Although 
you can never say new on an abstract class, 
an abstract class is still a superclass, so its 
constructor runs when someone makes an 
instance of a concrete subclass. 


The superclass constructors run to build 

out the superclass parts of the object. 

Remember, a subclass might inherit methods 

that depend on superclass state (in other words, 
the value of instance variables in the superclass). 
For an object to be fully formed, all the superclass 
parts of itself must be fully formed, and that’s why the 
superclass constructor must run. All instance variables 
from every class in the inheritance tree have to be 
declared and initialized. Even if Animal has instance 
variables that Hippo doesn’t inherit (if the variables 
are private, for example), the Hippo still depends on 
the Animal methods that use those variables. 


When a constructor runs, it immediately calls its 
superclass constructor, all the way up the chain until 
you get to the class Object constructor. 


On the next few pages, you'll learn how superclass 
constructors are called, and how you can call them 
yourself. You'll also learn what to do if your superclass 
constructor has arguments! 
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Animal 


A single Hippo object on the heap 


A new Hippo object also IS-A Animal 
and IS-A Object. If you want to make a 
Hippo, you must also make the Animal 
and Object parts of the Hippo. 


This all happens in a process called 
Constructor Chaining. 
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object construction 


Making a Hippo means making the 
Animal and Object parts too... 


public class Animal { 
public Animal() { 
System.out.printin("Making an Animal"); 
} 


public class Hippo extends Animal { 
public Hippo() { 
System. out .printi1n ("Making a Hippo"); 
} 
} 


public class TestHippo { 
public static void main(String[] args) { 
System. out .printlin("Starting..."); 
Hippo h = new Hippo(); 
} 
} 


Given the class hierarchy in the code above, we can step through the 
process of creating a new Hippo object. 


© Code from another 
class calls new 


Hippo() invokes 

the superclass 
constructor, which 
pushes the Animal() 
constructor onto the 
top of the stack. 


© 


Hippo (), and the 
Hippo() constructor 
goes into a stack 
frame at the top of 
the stack. 
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GeSharpen your pencil 
een your p 


What's the real output? Given the 
code on the left, what prints out 
when you run TestHippo? A or B? 


(The answer is at the bottom of the page.) 


% java TestHippo 
Starting... 
Making an Animal 


Making a Hippo 


% java TestHippo 
Starting... 


Making a Hippo 


Making an Animal 


© Animal() invokes © Object() completes, 
the superclass and its stack frame 
constructor, which is popped off the 


stack. Execution goes 
back to the Animal() 
constructor and 
picks up at the line 
following Animal's 
call to its superclass 
constructor. 


pushes the Object() 
constructor onto 
the top of the stack, 
since Object is the 
superclass of Animal. 


\ Animal 


"|SJ SAYSIUY JU} JOJONSUOD jewuy 3y} S4 
nq su} PAYOAUI SI JOJONIJSUOD (JoddiH ayL `y ‘auo ysu Əy L 


How do you invoke a superclass constructor? 


You might think that somewhere in, say, a Duck constructor, if 
Duck extends Animal you’d call Animal(). But that’s not how it 
works: 


public class Duck extends Animal { 


int size; 


public Duck(int newSize) { 
—-» Animal () ; <— No/ 


size = newSize; 


BAD! is j 
IS not. leg all 


The only way to call a superclass constructor is by calling super(). 
That’s right—super() calls the superclass constructor. 


What are the odds? 


public class Duck extends Animal { 


int size; 


public Duck(int newSize) { 


super () 7 = You just Call Super() 


size = newSize; 


A call to super() in your constructor puts the superclass 
constructor on the top of the Stack. And what do you think that 
superclass constructor does? Calls its superclass constructor. And so it 
goes until the Object constructor is on the top of the Stack. Once 
Object() finishes, it’s popped off the Stack, and the next thing 
down the Stack (the subclass constructor that called Object() 

is now on top. That constructor finishes and so it goes until the 
original constructor is on the top of the Stack, where it can now 
finish. 
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And how is it that we’ve 
gotten away without 
calling super() before? 


You probably figured that out. 


Our good friend the compiler 
puts in a call to super() if you 
don't. 


So the compiler gets involved in 
constructor-making in two ways: 


© If you don’t provide a constructor 
The compiler puts one in that looks like: 


public ClassName() { 
super (); 


} 


© If you do provide a constructor 
but you do not put in the call to 
super() 


The compiler will put a call to super() in 
each of your overloaded constructors.* 
The compiler-supplied call looks like: 


super (); 


It always looks like that. The compiler- 
inserted call to super() is always a no-arg 
call. If the superclass has overloaded 
constructors, only the no-arg constructor 
is called. 


*Unless the constructor calls another overloaded 
constructor (you'll see that in a few pages). 
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Can the child exist before 
the parents? Eewwww...that 


If you think of a superclass as the parent to the subclass child, you is SO creepy. There's 
can figure out which has to exist first. The superclass parts of an no way I could have been 
object have to be fully formed (completely built) before born before my parents. 


the subclass parts can be constructed. 
Remember, the subclass object might depend 
on things it inherits from the superclass, so it’s 


That's just wrong. 


important that those inherited things be finished. 
No way around it. The superclass constructor 
must finish before its subclass constructor. 


Look at the Stack series on page 254 again, and 
you can see that while the Hippo constructor 

is the first to be invoked (it’s the first thing on 
the Stack), it’s the last one to complete! Each 
subclass constructor immediately invokes its 
own superclass constructor, until the Object 
constructor is on the top of the Stack. Then 
Object’s constructor completes, and we 

bounce back down the Stack to Animal’s 
constructor. Only after Animal’s constructor 
completes do we finally come back down to finish the rest of the 
Hippo constructor. For that reason: 


The call to super() must be the first statement 
in each constructor!* 


Possible constructors for class Boop 


Vv public Boop() { 
[V| public Boop() { } =. These are OK betau 
Se 


super (); e Compiler il 
Th tall to will put a 
; i ese are OK because Mi public Boop (int i) { first E ale A as the 


plicit oram ton pleasent: i 
[V] public Boop (int i) { VR as agal l 
super0; «~ 
size = i; © public Boop(int i) { BADII This u 


size 


super () ; 


*There’s an exception to this rule; you'll learn it on page 258. 
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Superclass constructors with arguments 


What if the superclass constructor has arguments? Can you pass something in to the 
super() call? Of course. If you couldn’t, you’d never be able to extend a class that didn’t 
have a no-arg constructor. Imagine this scenario: all animals have a name. There’s a 
getName() method in class Animal that returns the value of the name instance variable. 
The instance variable is marked private, but the subclass (in this case, Hippo) inherits 
the getName() method. So here’s the problem: Hippo has a getName() method (through 
inheritance) but does not have the name instance variable. Hippo has to depend on the 
Animal part of himself to keep the name instance variable, and return it when someone 
calls getName() on a Hippo object. But...how does the Animal part get the name? The 
only reference Hippo has to the Animal part of himself is through super(), so that’s the 
place where Hippo sends the Hippo’s name up to the Animal part of himself, so that the 
Animal part can store it in the private name instance variable. 


public abstract class Animal { : 
All animals Cineluding, 


rivate String name; 
j j ' subclasses) have a name. 


public String getName() €— Å getter meth 
return name; iPPo inherits. 


} 


od that 


public Animal (String theName) 
name = theName; x es 


public class Hippo extends Animal { 


r . ; s a name- 
public Hippo (String eS Wippo ronstruttor take 


super (name) ; 


} 


e finimal Cons rutor 


public class MakeHippo { 
public static void main(String[] args) { 


Hippo h = new Hippo ("Buffy"); <—— Make a H; ; 
hame & PPo, assing th 

System. out .printin (h.getName()); tonat aa ” h Hire 
rul: : O 
Hippo’s inher Then call the 


} erited o¢tName() 
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Animal 
private String name 
Animal(String n) 


String getName() 


Hippo 


Hippo(String n) 


[other Hippo- 
specific methods] 


The Animal part of 
{ The me needs to know my name, 
ie Constructo, that so I take a name in my own Hippo 
constructor and then pass the 
name to super(). 


S$java MakeHippo 


Buffy 
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Invoking one overloaded constructor 
from another 


What if you have overloaded constructors that, with the 
exception of handling different argument types, all do the 
same thing? You know that you don’t want duplicate code 
sitting in each of the constructors (pain to maintain, etc.), so 
you'd like to put the bulk of the constructor code (including 
the call to super()) in only one of the overloaded constructors. 
You want whichever constructor is first invoked to call The 
Real Constructor and let The Real Constructor finish the 
job of construction. It’s simple: just say ¢his(). Or this(aString). 
Or this(27, x). In other words, just imagine that the keyword 
this is a reference to the current object. 


You can say ¢his() only within a constructor, and it must be 
the first statement in the constructor! 


But that’s a problem, isn’t it? Earlier we said that super/() 
must be the first statement in the constructor. Well, that 
means you get a choice. 


Every constructor can have a call to super() 
or this(), but never both! 


You'll need to choose which to call based on which 
values you have, which ones you need to set, and which 
constructors are provided in this class or the superclass. 


import java.awt.Color; 


class Mini extends Car { 
private Color color; 


The no-ar9, constructor 


lies a de 
at the overloaded Kea 
m Constructor (the one 


talls super ). 


public Mini() { 
this (Color.RED) ; 
} 


public Mini(Color c) { 
super ("Mini") ; 
color Cc; 
// more initialization 


} 


< ~ does The Real Work 


public Mini (int size) { 
Won't workll Can’t h ave 


this (Color.RED) = 
superl) and this() in the same 


super (size) ; 
} constructor, 


} 
must be the first statement! 
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because they each 


all a 


m another 


Use thisl) woe 


constructor fro 
constructor 1 


overloaded 
the same class. 
The call to this) 
can be used only in a 
e 
constructor, and must 
the first statement in a 
constructor. 
A constructor can have a 


call to superl) OR this), 
hut never both! 


fault Color and 
that 


This is The Real Constructor that 
(o: 


object Cineluding the call to super()), 


initializing the 


File Edit Window Help Drive 


javac Mini.java 


Mini.java:16: call to super must 
be first statement in constructor 


super (); 
Aa 


G harpen your pencil 
NN ——> Yours to solve. 


Some of the constructors in the SonOfBoo class will not 
compile. See if you can recognize which constructors are 
not legal. Match the compiler errors with the SonOfBoo 
constructors that caused them, by drawing a line from the 
compiler error to the “bad” constructor. 


public class Boo { 
public Boo (int i) { } 
public Boo (String s) { } 
public Boo (String s, int i) { } 
} 


class SonOfBoo extends Boo { 
public SonOfBoo() { 
super ("boo") ; 


public SonOfBoo(int i) { 
super ("Fred") ; 


public SonOfBoo(String s) { 
super (42) ; 


public SonOfBoo(int i, String s) { 
} 


public SonOfBoo(String a, String b, String c) 


super (a, b); 


public SonOfBoo(int i, int j) { 
super ("man", j); 


public SonOfBoo(int i, int x, int y) 


super (i, "star"); 


{ 


{ 
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threads 
wait() 


Woe, f 
at | | 
notify() a | 


File Edit Window Help 


Sjavac SonOfBoo. java 


cannot resolve symbol 


symbol constructor Boo 


(java.lang.String, java. 


lang. String) 


File Edit Window Help Yadayadayada 


Sjavac SonOfBoo. java 
cannot resolve symbol 


symbol constructor Boo 
(int, java.lang.String) 


File Edit Window Help ImNotListening 


Sjavac SonOfBoo. java 


cannot resolve symbol 


symbol:constructor Boo() 
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object lifespan 


Now we know how an object is born, 
but how long does an object live? 


An object's life depends entirely on the life of references 
referring to it. If the reference is considered “alive,” the object 
is still alive on the Heap. If the reference dies (and we'll look at 
what that means in just a moment), the object will die. 


So if an object’s life depends on the 
reference variable’s life, how long does a 
variable live? 

That depends on whether the variable is a local variable or 

an instance variable. The code below shows the life of a local 
variable. In the example, the variable is a primitive, but variable 
lifetime is the same whether it’s a primitive or reference variable. 


public class TestLifeOne { 


public void read() { 
int s = 42; S iss 


Cope, 
sleep (); method s the read( 
, ; ) 
} anywhere oo Cant be used 


s= 7; 
ci here 
use ° 


w variable: Snte 


e 
e 
5 own Stack fram , 


The Variable Wm 
readO method s alive, but 


still See  » € 
the Stack a» ead() ĉo O o read() Can 
ond is Po 
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y ching about t 


@ A local variable lives only 
within the method that 
declared the variable. 


public void read() { 

int s = 42; 

// `s’ can be used only 

// within this method. 

// When this method ends, 

// `s’ disappears completely. 
} 


Variable “s” can be used only within the 
read() method. In other words, the variable 
is in scope only within its own method. No 
other code in the class (or any other class) 


Hat 


can see s. 


An instance variable lives 
as long as the object 


does. If the object is still 
alive, so are its instance 
variables. 


public class Life { 
int size; 


public void setSize(int s) { 
size = s; 
// `s’ disappears at the 
// end of this method, 
// but ‘size’ can be used 
// anywhere in the class 

} 

} 


Variable ’‘s’ (this time a method parameter) 
is in scope only within the setSize() 
method. But instance variable size is 
scoped to the life of the object as opposed 
to the life of the method. 


The difference between life and 
scope for local variables: 


Life 


A local variable is alwe as long as its Stack 
frame is on the Stack. In other words, until the 
method completes. 


Scope 


A local variable is in scope only within the 
method in which the variable was declared. 
When its own method calls another, the vari- 
able is alive, but not in scope until its method 
resumes. You can use a variable only when 
it is in scope. 


Let’s walk through what happens on the stack 
when something calls the doStufff) method. 


doStuff() goes on the 2) go() plops on top of 

Stack. Variable “b” is the Stack. “x” and “z” 

alive and in scope. are alive and in scope, 
and “b” is alive but not 
in scope. 


While a local variable 1s alive, its state persists. As 
long as method doStufff) is on the Stack, for example, 
the “b” variable keeps its value. But the “b” variable 
can be used only while doStuff{)’s Stack frame is at 
the top. In other words, you can use a local variable 
only while that local variable’s method is actually 
running (as opposed to waiting for higher Stack 
frames to complete). 
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public void doStuff() { 
(1) boolean b = true; 
go(4); 
} 
public void go(int x) { 
int z = x + 24; 
crazy (); 
4) // imagine more code here 
} 


public void crazy() { 


(3) char c = 'a'; 


} 


crazy() is pushed (4) crazy() completes and 
onto the Stack, with is popped off the Stack, 
“c” now alive and in so ‘c’ is out of scope 
scope. The other three and dead. When go() 
variables are alive but resumes where it left 
out of scope. off, “x” and “x” are both 


alive and back in scope. 
Variable “b” is still alive 
but out of scope (until 
go() completes). 
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What about reference variables? 


The rules are the same for primitives and references. A reference variable 
can be used only when it’s in scope, which means you can’t use an object’s 
remote control unless you’ve got a reference variable that’s in scope. The real 
question is: 


“How does variable life affect object life?” 


An object is alive as long as there are live references to it. If a reference 
variable goes out of scope but is still alive, the object it refers to is still alive on 
the Heap. And then you have to ask...““What happens when the Stack frame 
holding the reference gets popped off the Stack at the end of the method?” 


If that was the only live reference to the object, the object is now abandoned 
on the Heap. The reference variable disintegrated with the Stack frame, so 
the abandoned object is now, officially, toast. The trick is to know the point at 
which an object becomes eligible for garbage collection. 


Once an object is eligible for garbage collection (GC), you don’t have to 
worry about reclaiming the memory that object was using. If your program 
gets low on memory, GC will destroy some or all of the eligible objects, to 
keep you from running out of RAM. You can still run out of memory, but 
not before all eligible objects have been hauled off to the dump. Your job 

is to make sure that you abandon objects (i.e., make them eligible for GC) 
when you're done with them, so that the garbage collector has something to 
reclaim. If you hang on to objects, GC can’t help you, and you run the risk 
of your program dying a painful out-of-memory death. 


An object’s life has no 
value, no meaning, no 
point, unless somebody 
has a reference to it. 


Tf you can’t get to it, 
you can’t ask it to do 
anything and it’s just a 
big fat waste of bits. 


But if an object is 
unreachable, the 
Garbage Collector will 
figure that out. Sooner 
or later, that object’s 
goin’ down. 


Three ways to get rid of an object’s reference: 


An object becomes 
eligible for GC when 


its last live reference void go() 4 


© The reference goes out of scope, permanently 


vekerentt ia di 


A Life z = new Life(); end of 
disappears. } ee 


@ The reference is assigned another object 
the xi 


Life z = new Life(); 


z = new Life(); 


© The reference is explicitly set to null 


Life z = new Life(); 


z = null; 
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Object-killer #1 


Reference goes 
out of scope, 
permanently. 


public class StackRef { 
public void foof() { 
barf (); 


I don't like where 
this is headed. 


} 


public void barf() { 
Duck d = new Duck(); 


} 


foof() is pushed onto the 
Stack; no variables are 
declared. 


barf() is pushed onto the 
Stack, where it declares 

a reference variable, and 
creates a new object as- 
signed to that reference. 
The object is created on 
the Heap, and the refer- 
ence is alive and in scope. 


Uh-oh. The ‘d’ variable went 
away when the barf() Stack 
frame was blown off the stack, 
so the Duck is abandoned. 
Garbage—collector bait. 


barf() completes and pops 
off the Stack. Its frame dis- 
integrates, so “d” is now 
dead and gone. Execution 
returns to foof(), but foof() 
can’t use “d.” 
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Object-killer #2 


Assign the reference 
to another object 


Dude, 
all you had to do 


public class ReRef { 
Duck d = new Duck(); 
was reset the reference. 
Guess they didn't have 
memory management back 


public void go() { 
d = new Duck(); 


Year 


Rep 7 ee" 


tk ooes on the Heap, referenced 
a wp is an instance variable, the 
Duck will live as long as the ReRef object 
that instantiated X is alive. Unless... 


Weak 
uck oe 


Spee abe 


P is assioned a new Duck object, leaving the 
ada Duek object Sbandoned. That 
First Duck is now as good as dead. 
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Object-killer #3 


Explicitly set the 
reference to null 


public class ReRef { 
Duck d = new Duck(); 


public void go() { 
d = null; 


The meaning of null 


When you set a reference to null, you're 
deprogramming the remote control. 

In other words, you've got a remote 
control, but no TV at the other end. A null 
reference has bits representing “null” (we 
don't know or care what those bits are, as 
long as the JVM knows). 


If you have an unprogrammed remote 
control, in the real world, the buttons 
don't do anything when you press them. 
But in Java, you can't press the buttons 
(i.e. use the dot operator) on a null 
reference, because the JVM knows (this is 
a runtime issue, not a compiler error) that 
you're expecting a bark, but there’s no 
Dog there to do it! 


If you use the dot operator on 


a null reference, you'll get a 


NullPointerException at runtime. You'll 
learn all about exceptions in Chapter 13, 
Risky Behavior. 
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tk ooes on the Heap, referenced 
Nicene Fi ” is an instance variable, the 


Duck will live as long as the ReRef object 
that instantiated it is alive. Unless... 


. . . . . mote 
R is set to null, which is ust like having a vemo’ 
Ais that isn’t peoaranned to anything. o 
even allowed to use the dot operator on d until i 


reprogrammed (assigned an object). 
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Fireside Chats 
Ye 
g Wn" \f 


Instance Variable 

Td like to go first, because I tend to be more 
important to a program than a local variable. Pm 
there to support an object, usually throughout 
the object’s entire life. After all, what’s an object 
without state? And what is state? Values kept in 
instance variables. 


No, don’t get me wrong, I do understand your 
role in a method; it’s just that your life is so short. 
So temporary. That’s why they call you guys 
“temporary variables.” 


My apologies. I understand completely. 


I never really thought about it like that. What are 
you doing while the other methods are running 
and yow’re waiting for your frame to be the top of 
the Stack again? 
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Tonight’s Talk: An instance variable and 
a local variable discuss life and death 
(with remarkable civility) 


Local Variable 


I appreciate your point of view, and I certainly 
appreciate the value of object state and all, but I 
don’t want folks to be misled. Local variables are 
really important. To use your phrase, “After all, 
what’s an object without behavior?” And what is 
behavior? Algorithms in methods. And you can 
bet your bits there’ll be some local variables in there 
to make those algorithms work. 


Within the local-variable community, the phrase 
“temporary variable” is considered deroga- 
tory. We prefer “local,” “stack,” “automatic,” or 
“Scope-challenged.” 


Anyway, it’s true that we don’t have a long life, 
and it’s not a particularly good life either. First, 
we're shoved into a Stack frame with all the other 
local variables. And then, if the method we’re 
part of calls another method, another frame is 
pushed on top of us. And if that method calls 
another method...and so on. Sometimes we have to 
wait forever for all the other methods on top of 
the Stack to complete so that our method can run 
again. 


Nothing. Nothing at all. It’s like being in stasis— 
that thing they do to people in science-fiction 
movies when they have to travel long distances. 
Suspended animation, really. We just sit there on 
hold. As long as our frame is still there, we’re safe 
and the value we hold is secure, but it’s a mixed 
blessing when our frame gets to run again. On the 
one hand, we get to be active again. On the other 


Instance Variable 


We saw an educational video about it once. Looks 
like a pretty brutal ending. I mean, when that 
method hits its ending curly brace, the frame is 
literally blown off the Stack! Now that’s gotta hurt. 


I live on the Heap, with the objects. Well, not 
with the objects, actually in an object. The object 
whose state I store. I have to admit life can be 
pretty luxurious on the Heap. A lot of us feel 
guilty, especially around the holidays. 


OK, hypothetically, yes, if Pm an instance 
variable of the Collar and the Collar gets GC’d, 
then the Collar’s instance variables would indeed 
be tossed out like so many pizza boxes. But I was 
told that this almost never happens. 


They let us drink? 
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Local Variable 


hand, the clock starts ticking again on our short 
lives. The more time our method spends running, 
the closer we get to the end of the method. We all 
know what happens then. 


Tell me about it. In computer science they use the 
term popped as in “the frame was popped off the 
Stack.” That makes it sound fun, or maybe like 
an extreme sport. But, well, you saw the footage. 
So why don’t we talk about you? I know what my 
little Stack frame looks like, but where do you live? 


But you don’t always live as long as the object 
who declared you, right? Say there’s a Dog object 
with a Collar instance variable. Imagine you’re 
an instance variable of the Collar object, maybe 
a reference to a Buckle or something, sitting 
there all happy inside the Collar object who’s all 
happy inside the Dog object. But...what happens 
if the Dog wants a new Collar or nulls out its 
Collar instance variable? That makes the Collar 
object eligible for GC. So...if you’re an instance 
variable inside the Collar and the whole Collar is 
abandoned, what happens to you? 


And you believed it? That’s what they say to 

keep us motivated and productive. But aren’t 

you forgetting something else? What if you’re an 
instance variable inside an object, and that object 
is referenced only by a local variable? If Pm the 
only reference to the object you’re in, when I go, 
you're coming with me. Like it or not, our fates 
may be connected. So I say we forget about all 
this and go get a drink while we still can. Carpe 
RAM and all that. 
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exercise: Be the Garbage Collector 


BE the Garbage Collector 


Which of the lines of code on the right, if added to 
the class on the left at point A, would cause exactly 
one additional object to he eligible for the Garbage 
Collector? (Assume that point A (//cal] more methods) 
will execute for a long time, giving the Garbage 
Collector time to do its stuff.) 


public class GC { 
public static GC doStuff() { 
GC newGC = new GC(); 
doStuff2 (newGC) ; 
return newGC; 1 copyGC = null; 


————> Answers on page 272. 


2 gc2 = null; 
public static void main(String[] args) { 


GC gcl; 

GC gc2 = new GC(); 3  newGC = gc3; 
GC gc3 = new GC(); 

GC gc4 = gc3; 4 gcl = null; 


gcl = doStuff(); 


Q 


// call more methods 


} 7  gce3 = gc2; 


5 newGC = null; 


6 gc4 = null; 


public static void doStuff2 (GC copyGC) { 


8 gcl = gc4; 
GC localGC = copyGC; 


} 9 gce3 = null; 
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In this code example, several new objects are created. 
Popular Your challenge is to find the object that is “most popular,’ 

i.e., the one that has the most reference variables refer- 

ring to it. Then list how many total references there are 
o © for that object, and what they are! We'll start by pointing 
Ñ ects out one of the new objects and its reference variable. 


Good luck! 


class Bees { 
Honey[] beeHoney; 


————— Answers on page 272. 
class Raccoon { 
Kit rk; 
Honey rh; 


class Kit { 
Honey honey; 


class Bear { 
Honey hunny; 


public class Honey { 
public static void main(String[] args) { 
Honey honeyPot = new Honey(); 
Honey[] ha = {honeyPot, honeyPot, honeyPot, honeyPot}; 
Bees bees = new Bees(); 
bees. beeHoney = ha; 
Bear[] bears = new Bear[5]; 
for (int i = 0; i < 5; itt) { 
bears[i] = new Bear(); 
bears [i].hunny = honeyPot; 
} Here's a new Raccoon object! 
Kit kit = new Kit(); 
kit.honey = honeyPot; 
Raccoon raccoon = new Raccoon (); 


ae Here's its reference variable ‘raccoon.’ 


raccoon.rh = honeyPot; 
raccoon.rk = kit; 
kit = null; 

} // end of main 
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puzzle: Five Minute Mystery 


“We’ve run the simulation four times, and the main module’s temperature consistently 
drifts out of nominal toward cold,” Sarah said, exasperated. “We installed the new temp-bots last 
week. The readings on the radiator bots, designed to cool the living quarters, seem to be within 
spec, so we’ve focused our analysis on the heat retention bots, the bots that help to warm the quar- 
ters.” Tom sighed, at first it had seemed that nanotechnology was going to really put them ahead 
of schedule. Now, with only five weeks left until launch, some of the orbiter’s key life support 
systems were still not passing the simulation gauntlet. 


“What ratios are you simulating?” Tom asked. 


Myster y “Well, if I see where you’re going, we already thought of that,” Sarah replied. “Mission 
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control will not sign off on critical systems if we run them out of spec. We are required 
to run the v3 radiator bot’s SimUnits in a 2:1 ratio with the v2 radiator’s SimUnits,” 


Sarah continued. “Overall, the ratio of retention bots to radiator bots is supposed to run 
4:3.” 


“How’s power consumption, Sarah?” Tom asked. Sarah paused, “Well, that’s 
another thing, power consumption is running higher than anticipated. We’ve got a team 
tracking that down too, but because the nanos are wireless, it’s been hard to isolate the power 
consumption of the radiators from the retention bots.” “Overall power consumption ratios,” Sarah 
continued, “are designed to run 3:2 with the radiators pulling more power from the wireless grid.” 


“OK, Sarah,” Tom said. “Let’s take a look at some of the simulation initiation code. 
We’ ve got to find this problem, and find it quick!” 


import java.util.ArrayList; 


class V2Radiator { 
v2Radiator (ArrayList<SimUnit> list) { 
for (int x = 0; x < 5; x++) { 
list.add(new SimUnit ("V2Radiator")); 


class V3Radiator extends V2Radiator { 
V3Radiator (ArrayList<SimUnit> lglist) { 
super (lglist) ; 
for (int g = 0; g < 10; g++) { 
lglist.add(new SimUnit ("V3Radiator") ); 


class RetentionBot { 
RetentionBot (ArrayList<SimUnit> rlist) { 
rlist.add(new SimUnit ("Retention") ); 
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5 5 import java.util.ArrayList; 
Five-Minute 

public class TestLifeSupportSim { 
Mystery 


public static void main(String[] args) { 
z 2 d ArrayList<SimUnit> aList = new ArrayList<SimUnit>(); 
Coltfinue oo V2Radiator v2 = new V2Radiator(aList); 
V3Radiator v3 new V3Radiator(aList) ; 
for (int z= 0; 2 < 20; zt+t) { 
RetentionBot ret = new RetentionBot (alist) ; 


class SimUnit { 
String botType; 


SimUnit (String type) { 
botType = type; 


int powerUse() { 


if ("Retention".equals(botType)) { 
return 2; 

} else { 
return 4; 


} 


Tom gave the code a quick look, and a small smile crept across his lips. “I think I’ ve 


found the problem, Sarah, and I bet I know by what percentage your power usage readings are off 
too!” 


What did Tom suspect? How could he guess the power readings errors, and what few 
lines of code could you add to help debug this program? 


—————> Answers on page 273. 
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object lifecycle 


1 copyGc = null; No—this line attempts to access a variable 
that is out of scope. 


a ee 2 gc2 = null; OK—gc2 was the only reference variable 
Exercise Solutions referring to that object. 
3 newGc = gc3; No—another out of scope variable. 
4 gel = null; OK-—gcl had the only reference because 
Be the Garbage newGC is out of scope. 
GC = null; = i 
Collector 5 new nu No—newGC is out of scope. 
(from page 268) 6 gc4 = null; No—gc3 is still referring to that object. 
7 gc3 = 902; No—gc4 is still referring to that object. 
8 gel = gc4; OK—Reassigning the only reference to 


that object. 
9 gc3 = null; No—gc4 is still referring to that object. 


: It probably wasn't too hard to figure out that the Honey object first referred to by the honeyPot variable is by 
Popular far the most “popular” object in this class. But maybe it was a little trickier to see that all of the variables that 
A point from the code to the Honey object refer to the same object! There are a total of 12 active references 
0 X ects to this object right before the main() method completes. The kit.honeyPot variable is valid for a while, but 
kit gets nulled at the end. Since raccoon.rk still refers to the Kit object, raccoon.kit.honeyPot (although never 


(from page 269) explicitly declared) refers to the object! 
public class Honey { 
public static void main(String[] args) { 
Honey honeyPot = new Honey (); 
Honey[] ha = {honeyPot, honeyPot, 
honeyPot, honeyPot}; 
Bees bees = new Bees(); 
| — bees.beeHoney = ha; 
Bear[] bears = new Bear[5]; 
for (int i = 0; i < 5; itt) { 
| =m Honey bears[i] = new Bear(); 
—5 Object l bears [i] .hunny honeyPot; 
T TTT (ends up null) Kit kit = new Kit; 
| | kit.honey = honeyPot; 


Raccoon raccoon = new Raccoon (); 


raccoon.rh = honeyPot; 


raccoon.rk = kit; 
kit = null; 
} // end of main 
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Five-Minute Mystery (from pages 270-271) 


Tom noticed that the constructor for the V2Radiator class took an 
ArrayList. That meant that every time the V3Radiator constructor was called, 
it passed an ArrayList in its super() call to the V2Radiator constructor. That 
meant that an extra five V2Radiator SimUnits were created. If Tom was right, 
total power use would have been 120, not the 100 that Sarah’s expected ratios 
predicted. 


Since all the Bot classes create SimUnits, writing a constructor for 
the SimUnit class, which printed out a line every time a SimUnit was created, 
would have quickly highlighted the problem! 
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10 numbers and statics 


Numbers Matter 


Do the Math. But there's more to working with numbers than just doing primitive 
arithmetic. You might want to get the absolute value of a number, or round a number, or find 
the larger of two numbers. You might want your numbers to print with exactly two decimal 
places, or you might want to put commas into your large numbers to make them easier to read. 
And what about parsing a String into a number? Or turning a number into a String? Someday 
you're gonna want to put a bunch of numbers into a collection like ArrayList that takes only 
objects. You're in luck. Java and the Java API are full of handy number-tweaking capabilities and 
methods, ready and easy to use. But most of them are static, so we'll start by learning what 

it means for a variable or method to be static, including constants in Java, also known as static 


final variables. 
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Math methods 


MATH methods: as close as you'll 
ever get to a global method 


Except there’s no global anything in Java. But think about this: 
what if you have a method whose behavior doesn’t depend 
on an instance variable value. Take the round() method in the 
Math class, for example. It does the same thing every time— 
rounds a floating-point number (the argument to the method) 
to the nearest integer. Every time. If you had 10,000 instances 
of class Math, and ran the round(42.2) method, you’d get an 
integer value of 42. Every time. In other words, the method 
acts on the argument but is never affected by an instance 
variable state. The only value that changes the way the round() 
method runs is the argument passed to the method! 


Doesn’t it seem like a waste of perfectly good heap space to 
make an instance of class Math simply to run the round() 
method? And what about other Math methods like min(), which 
takes two numerical primitives and returns the smaller of the 
two? Or max(). Or abs(), which returns the absolute value of a 
number. 


These methods never use instance variable values. 
In fact, the Math class doesn’t have any instance variables. So 
there’s nothing to be gained by making an instance of class 
Math. So guess what? You don’t have to. As a matter of fact, 
you can’t. 


If you try to make an instance of 
class Math: 


Math mathObject = new Math(); 


You’ll get this error: 


File Edit Window Help lwasToldThereWouldBeNoMaths 


Sjavac TestMath 


access in java.lang.Math 


Math mathObject = new Math(); 


TestMath.java:3: Math() has private This error sh 
Ows 


Constructor iS mð 
medns You Can NEVER 


Methods in the Math class 
don’t use any instance 
variable values. And because 
the methods are “Static,” 
you don’t need to have an 
instance of Math. All you 
need is the Math class. 


long x = Math.round (42.2); 
int y Math.min(56, 12); 
int z = Math.abs (-343) ; 


These methods never use 
instance variables, so their 

pee doesn't need to 
now about a specifie object. 


that the Math 
rked Private! Th, at 


Aa Math Class to makea ti ‘new on the 


1 error 
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ew Math object. 
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The difference between regular 
(non-static) and static methods 


Java is object-oriented, but once in a while you have a special case, typically 
a utility method (like the Math methods), where there is no need to have an 
instance of the class. The keyword static lets a method run without any 
instance of the class. A static method means “behavior not dependent on 
an instance variable, so no instance/object is required. Just the class.” 


regular (non-static) method 
aise Instante variable value affects the 
nstan' 


hod- 
behavior of the play metho 


static method 


public class Song { 
String title; 


public Song(String t) { public static int min(int a, int b) { 
title = t; 
} _— á //returns the smallest of a and b 
public void play() { 
SoundPlayer player = new SoundPlayer (); 


: s. The 
player .playSound (title); No instance variable D 


i doesn 
} ithe th od behavior 
} ai he of the “tt a pA e with instante 
Toe tureen sn ib 
instante varia = variable state: 


y Way 


ex Pistol 


Politik S 
Coldplay Soro 
b Math.min (42,36); 
w> 
Class name, vather 
ey erene variable 
name: 
Song 
5 
ong s3.play(); N 
7 a -play (); 0 OBJECT) 
in 
“ te P. lay, 2 : Abso| utel 
folis wil a, Shis rele j ant < this anywher, : OBJEC TS 
Play “= Way” ni ry es My € in this Pitture / 
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static methods 


Call a static method using a 


class name 


Math 


min() 
max() 
abs() 


-~ 


Math.min (88,86); 


Call a non-static method using a 
reference variable name 


What it means to have a 
class with static methods 


Often (although not always), a class with static methods is not 
meant to be instantiated. In Chapter 8, Serious Polymorphism, 
we talked about abstract classes, and how marking a class 
with the abstract modifier makes it impossible for 
anyone to say “new” on that class type. In other words, it’s 
impossible to instantiate an abstract class. 


But you can restrict other code from instantiating a 
non-abstract class by marking the constructor private. 
Remember, a method marked private means that only code 
from within the class can invoke the method. A constructor 
marked private means essentially the same thing—only 
code from within the class can invoke the constructor. 
Nobody can say “new” from outside the class. That’s how it 
works with the Math class, for example. The constructor 
is private; you cannot make a new instance of Math. The 
compiler knows that your code doesn’t have access to that 
private constructor. 
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Song t2 


= new Song(); 


t2.play(); 


This does not mean that a class with one or more static 
methods should never be instantiated. In fact, every class 
you put a main() method in is a class with a static method 
in it! 

Typically, you make a main() method so that you can 
launch or test another class, nearly always by instantiating 
a class in main and then invoking a method on that new 
instance. 


So you're free to combine static and non-static methods in 
a Class, although even a single non-static method means 
there must be some way to make an instance of the class. 
The only ways to get a new object are through “new” or 
deserialization (or something called the Java Reflection 
API that we don’t go into). No other way. But exactly who 
says new can be an interesting question, and one we'll 
look at a little later in this chapter. 


Static methods can't use non-static 
(instance) variables! 


Static methods run without knowing about any particular instance 
of the static method’s class. And as you saw on the previous pages, 
there might not even be any instances of that class. Since a static 
method is called using the class (Math.random()) as opposed to 

an instance reference (€2.play()), a static method can’t refer to any 
instance variables of the class. The static method doesn’t know 
which instance’s variable value to use. 


If you try to compile this code: 


public class Duck { 
private int size; 


public static void main(String[] args) { 
System.out.printin("Size of duck is " + size); 


} 


public void setSize(int s) { 


} an else in the elass is NO 


Statie context- Everything 


static. 


public int getSize() { 
return size; 
} 
} 


I'm sure they're 
talking about MY 
size variable. 


You'll get this error: 


% javac Duck. java 
Duck.java:6: non-static variable 


size cannot be referenced from a 
static context 


System.out.println ("Size 


of duck is " + size); 


A 
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If you try to use an 
instance variable from 
inside a static method, 
the compiler thinks, 

“I don’t know which 
object’s instance 
variable you're talking 
about!” If you have ten 
Duck objects on the 
heap, a static method 
doesn’t know about 
any of them. 


No, I'm pretty sure 
they're talking about 
MY size variable. 
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static methods 


Static methods can't use non-static plete? acto 
methods, either! umb Questions 


Q: What if you try to call a non-static 
method from a static method, but the 
non-static method doesn’t use any in- 
stance variables. Will the compiler allow 


What do non-static methods do? They usually use instance 
variable state to affect the behavior of the method. A 


getName() method returns the value of the name variable. Whose that? 
name? The object used to invoke the getName() method. 
= 5 =a Calling getSi QO : A: r 
This won’t compile: the inevib able. just Postpones - No. The compiler knows that 
ese: te esi) uses whether you do or do not use instance 
public class Duck { "stance variable. variables in a non-static method, you can. 
private int size; And think about the implications...if you 
were allowed to compile a scenario like 
public static void main(String[] args) { that, then what happens if in the future 
System.out.println("Size is " + getSize()); you want to change the implementation 


of that non-static method so that one day 
it does use an instance variable? Or worse, 
what happens if a subclass overrides the 
method and uses an instance variable in 
the overriding version? 


} 


public void setSize(int s) { 
size = s; 


} 


ublic int getSize() { voblem.-- Q: 
j fa ‘ the same p : lcould swear I’ve seen code that 
return size; 


} ase size’ calls a static method using a reference 
} V variable instead of the class name. 


Å: You can do that, but as your mother 
always told you, “Just because it’s legal 
doesn’t mean it’s good.” Although it works 
Duck.java:5: error: non-static to call a static method using any instance 
method getSize() cannot be refer- of the class, it makes for misleading (less- 
enced from a static context readable) code. You can say, 


File Edit Window Help Jack-in 
% javac Duck.java 


System.out.println("Size is " Duck d = new Duck (); 


getSize()); T erties = {}; 


A Bd a This code is legal, but the compiler just 
1 error : ¢ RD resolves it back to the real class anyway 
— (“OK, dis of type Duck, and main() is 
static, so I'll call the static main() in class 
Roses are red, T Duck”). In other words, using d to invoke 
and known to bloom la main() doesn't imply that main() will have 
any special knowledge of the object that d 
Statics can’t see is referencing. It’s just an alternate way to 
i e variable state invoke a static method, but the method is 
instanc still static! 
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Static variable: 


value is the same for ALL 
instances of the class 


Imagine you wanted to count how many Duck instances 
are being created while your program is running. How 
would you do it? Maybe an instance variable that you 
increment in the constructor? 


class Duck { 
int duckCount = 0; 
public Duck() { 
duckCount++; this would di 
} dutkCount b ie set 


} eath time 
e 


a Duek Was mad 


No, that wouldn’t work because duckCount is an instance 
variable, and starts at 0 for each Duck. You could try 
calling a method in some other class, but that’s kludgey. 
You need a class that’s got only a single copy of the 
variable, and all instances share that one copy. 


That’s what a static variable gives you: a value shared by 
all instances of a class. In other words, one value per class, 
instead of one value per instance. 


getSize() 
setSize() 


numbers and statics 


k 
) «Cow 
: eae alized ONLY 


public class Duck { 
private int size; 
private static int duckCount = 0; 


public Duck() { Now it will kee 
duckCount++; <—'!nCrementi, 


9 each 4; 
: he Due OU 
Cause duekC or runs, 
and won't be st n O tie 
public void setSize (int s) { l 
size = S; 
} 
public int getSize() { 
return size; 
} 
. Lory 
esn t keet its own 
A uek dojeti do bi ects 
ok guekCoun e pi iby pa i Trk 
e utk Cow" t Yor at lives 
Bera a Smoje cory i ariavle 
al shave at yaridble 3 £ a ooje? 
ta LASS anstead : 
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static variables 


statie variable: kid instance two 
iceCream 


kid instance one 


Static variables are shared. 


All instances of the same 
class share a single copy of 
the static variables. 


instance variables: 1 per instance 
static variables: 1 per class 


i 


Y) : 
Brain Barbell 


Earlier in this chapter, we saw that a private 
constructor means that the class can't be instantiated 
from code running outside the class. In other words, 
only code from within the class can make a new 
instance of a class with a private constructor. (There's 
a kind of chicken-and-egg problem here. ) 


What if you want to write a class in such a way that 
only ONE instance of it can be created, and anyone 
who wants to use an instance of the class will always 
use that one, single instance? 
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Initializing a static variable 


Static variables are initialized when a class ts loaded. A class 1s loaded 
because the JVM decides it’s time to load it. Typically, the JVM 
loads a class because somebody’s trying to make a new instance of 
the class, for the first time, or use a static method or variable of the 
class. As a programmer, you also have the option of telling the JVM 
to load a class, but you’re not likely to need to do that. In nearly all 
cases, you're better off letting the JVM decide when to load the class. 


And there are two guarantees about static initialization: 


numbers and statics 


All static variables 
in a class are 
initialized before 
any object of 

that class can be 
created. 


e — Static variables in a class are initialized before any object of that 
class can be created. 


e — Static variables in a class are initialized before any static method 
of the class runs. 


eee. leaded. 
pee The Hays a Ea mA OMe we drt ved ta 
ii itiali ; > : 
o m de detault value for ints- Statie variables 
get default values just like instance variables. 


static int playerCount = 0; 

private String name; 

public Player(String n) { 
name = n; 


playerCount++; 


Default values for 

i or declared b i 
| static and instance variables ie the same: 
Primitive integers (long, short, ete.): O 


Primitive Floating Points (Float, double): 0.0 
boolean: false | 


nitialized 


public class PlayerTestDrive { 


public static void main(String[] args) { 


System. out .printin (Player.playerCount) ; object references: null 


Player one = new Player("Tiger Woods") ; 


System.out .printin (Player.playerCount) ; 


T Aecess a static variable just like a static 
i method—with the class name. 


If you don’t explicitly initialize a static variable (by assigning it a val- 
ue at the time you declare it), it gets a default value, so int variables % java PlayerTestDrive 
are initialized to zero, which means we didn’t need to explicitly say 
playerCount = 0. Declaring, but not initializing, a static variable Ce Before any instances ave made 
means the static variable will get the default value for that vari- 
able type, in exactly the same way that instance variables are given 


default values when declared. 


1 
a After an object is Created 
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static final variables are constants 


A variable marked final means that—once initialized—it can never 
change. In other words, the value of the static final variable will stay the 
same as long as the class is loaded. Look up Math.PI in the API, and 


you'll find: 


public static final double PI = 3.141592653589793; 
The variable is marked public so that any code can access it. 


The variable is marked static so that you don’t need an instance of 
class Math (which, remember, you’re not allowed to create). 


The variable is marked final because PI doesn’t change (as far as Java 


is concerned). 


There is no other way to designate a variable as a constant, but there 


is a naming convention that helps you to recognize one. Constant 


variable names are usually in all caps! 


Initialize a final static variable: 


© At the time you declare it: 


public class ConstantInit2 { 


public static final int X_VALUE = 25; 


Notice 4 N 
Final varapj 9 Convention 
name should © Constants co nati 
Nderstore sep Velie tase, with K 
OR ng th ords. an 


© In a static initializer: 


public class ConstantInit3 { 
public static final double VAL; 


static { 
VAL = Math.random (); 
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A static initializer is a block 
of code that runs whena 
class is loaded, before any 
other code can use the 
class, so it’s a great place 
to initialize a static final 
variable. E 


class ConstantIniti1i { 
final static int X; 


static { 


If you don't give a value to a final variable 
in one of those two places: 


public class ConstantInit3 { 


public static final double VAL; 


} no initialization I 


The compiler will catch it: 


javac ConstantInit3.java 
ConstantInit3.java:2: error: vari- 


able VAL not initialized in the 
default constructor 


public static final double VAL; 


A 


1 error 


final isnt just for static 
variables... 


You can use the keyword final to modify non-static 
variables too, including instance variables, local 
variables, and even method parameters. In each case, it 
means the same thing: the value can’t be changed. But 
you can also use final to stop someone from overriding a 
method or making a subclass. 


non-static final variables 
class Foof { 
final int size = 3; 
final int whuffie; 


e— now you cant change size 


Foof() { ce, 
whuffie = 42; now You Can + change whurrie 
} 


void doStuff (final int x) { 
// you can’t change x 


} 


void doMore() { 
final int z = 7; 
// you can’t change z 
} 
} 


final method 


class Poof { 
final void calcWhuffie() { 
// important things 
// that must never be overridden 


} 


final class 


final class MyMostPerfectClass { 
// cannot be extended 


} 
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A final variable means you 
can’t change its value. 


A final method means you 
can’t override the method. 


A final class means you 
can’t extend the class Gie., 
you can’t make a subclass). 


It's all so...so final. 
I mean, if I'd known 
I wouldn't be able to 
change things... 
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static and final 


there, are_no 


Dumb Questions 


- A static method can’t access a 
non-static variable. But can a non-static 
method access a static variable? 


A: Of course. A non-static method in a 
class can always call a static method in the 
class or access a Static variable of the class. 


: Why would I want to make a class 
final? Doesn't that defeat the whole 
purpose of OO? 


A: Yes and no. A typical reason for 
making a class final is for security. You 
can't, for example, make a subclass of the 
String class. Imagine the havoc if someone 
extended the String class and substituted 
their own String subclass objects, 
polymorphically, where String objects 

are expected. If you need to count ona 
particular implementation of the methods 
in a class, make the class final. 


Q: Isn't it redundant to have to mark 
the methods final if the class is final? 


A: If the class is final, you don’t need to 
mark the methods final. Think about it—if 
a class is final, it can never be subclassed, 
so none of the methods can ever be 
overridden. 


On the other hand, if you do want to allow 
others to extend your class and you want 
them to be able to override some, but not 
all, of the methods, then don’t mark the 
class final, but go in and selectively mark 
specific methods as final. A final method 
means that a subclass can’t override that 
particular method. 
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_—______— BULLET POINTS 


A static method should be called using the class 
name rather than an object reference variable: 
Math.random () versus myFoo.go() 


A static method can be invoked without any instances 
of the method’s class on the heap. 


Astatic method is good for a utility method that does 
not (and will never) depend on a particular instance 
variable value. 


Astatic method is not associated with a particular 
instance—only the class—so it cannot access any 
instance variable values of its class. It wouldn’t know 
which instance’s values to use. 


Astatic method cannot access a non-static method, 
since non-static methods are usually associated with 
instance variable state. 


If you have a class with only static methods and you 
do not want the class to be instantiated, you can mark 
the constructor private. 


A static variable is a variable shared by all members 
of a given class. There is only one copy of a static 
variable in a class, rather than one copy per each 
object for instance variables. 


Astatic method can access a static variable. 


To make a constant in Java, mark a variable as both 
static and final. 
A final static variable must be assigned a value either 
at the time it is declared or in a static initializer: 
static { 

DOG_CODE = 420; 
} 
The naming convention for constants (final static 
variables) is to make the name all uppercase and use 
underscores (_) to separate the words. 


A final variable value cannot be changed once it has 
been assigned. 


Assigning a value to a final instance variable must be 
either at the time it is declared or in the constructor. 


A final method cannot be overridden. 


A final class cannot be extended (subclassed). 
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Tadharpen your pencil 
ee Ep 
What’s Legal? KEEP 


Given everything you've just =m 


learned about static and final, 


which of these would compile? R | G H T 


public class Foo { 
static int x; 


public void go() { public class Foo4 { 
System. out .print1n (x); static final int x = 12; 
} 
} public void go() { 


System.out.println (x); 
} 


© public class Foo2 { 


int x; 
public static void go() { public class Foo5 { 
System. out .print1n (x) ; static final int x = 12; 
} 
} public void go(final int x) { 


System. out .printin (x) ; 
} 


© public class Foo3 { 
final int x; 
© public class Foo6 { 


public void go() { int x = 12; 
System. out .println (x); 
} public static void go(final int x) { 
} System. out .println (x); 


} 


—————> Answers on page 308. 
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Math methods 


Math methods 


Now that we kn 
ow how stati 
Math. This isn’ c methods work, let’s | 
2 t all of : ; > s look at à 4 
of them, just the highlights. Check ie erat a eres 
e rest including 


cos(), sin(), tan(), ceil(), floor(), and asin() 


T Ali Methods | Static Methods | Concrete Methods 


Modifier and Type Method 


static double 
static float 
static int 
static long 


static int 
static long 


static double 
static int 

static long 

static double 
static double 
static double 
static double 


static double 


static double 
static float 
static double 


static double 


chapter 10 


abs (double a) 
abs(float a) 
abs(int a) 
abs(long 2) 


absExact(int a) 


absExact (Long a) 


acos(double ê) 

addExact (int X, int y) 
addExact(Long X: Long Y) 
asin(double a) 
atan(double a) 
atan2(double Y: double x) 
cbrt(double a) 


ceil(double a) 


copySign (double magnitude, 


copySign (float magnitude, float sign) 


cos (double a) 


cosh(double x) 


Description 


Returns the absolute value ofadi 
Returns the absolute value ofaf 


Returns the absolute value of an 


Returns the mathematical absolu! 
ArithmeticException if the resul 


Retums the mathematical absolu! 
ArithmeticException if the resi 


Returns the arc cosine of a value; 
Returns the sum of its arguments. 
Returns the sum of its arguments; 
Returns the arc sine of a value; 
Returns the arc tangent of a value 
Returns the angle theta from the 
Returns the cube root of a doubli 


Returns the smallest (closest to n 
a mathematical integer. 


Returns the trigonometric cosine 


Returns the hyperbolic cosine of 


Math.abs() 


aA = Math.abs (-240) ; 
le d = Math.abs (240.45); 


Math.random() 


Returns a doubl 
e between (and i i 
through (but not inclu on i including) 0.0 


int r2 


= (int) 


Math. random O) ; 
(Math.random() * 5); 


Returns a doubl i 
e that is the absolu 
te val 
argument. The method is overloaded so if A 


pass it an int, it . 
, 1t returns an ın i 
returns a double: t. Pass it a double, it 


// returns 240 
// returns 240.45 


We've been using this 
method s0 Car, lov 
also ava \ Random 
is 3 Yt nicer ko use 
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Math.round() 


Returns an int or a long (depending on 
whether the argument is a float or a double) 


rounded to the nearest integer value. 
i Remember, Floating-point literals are assumed 


to be doubles unless you add the ‘f.’ 


int x Math.round(-24.8£); // returns -25 
int y = Math.round(24.45f); // returns 24 


long z = Math.round(24.45); // returns 24L 
This is a double. 


Math.min() 


Returns a value that is the minimum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles. 


int x = Math.min(24, 240); // returns 24 
double y = Math.min(90876.5, 90876.49); // returns 90876.49 


Math.max() 


Returns a value that is the maximum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles. 


int x = Math.max(24,240); // returns 240 
double y = Math.max(90876.5, 90876.49); // returns 90876.5 


Math.sqrt() 


Returns the positive square root of the argu- 
ment. The method takes a double, but of 
course you can pass in anything that fits in a 


double. 


double x Math.sqrt (9) ; //return 3 
double y = Math.sqrt (42.0); // returns 6.48074069840786 
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Wrapping a primitive 


Sometimes you want to treat a primitive like an 
object. For example, collections like ArrayList only 
work with Objects: 


ArrayList<???> list; 


e create dM 


Can Wr t for mts? 


Aevray 


There’s a wrapper class for every primitive type, 
and since the wrapper classes are in the java.lang 
package, you don’t need to import them. You can 
recognize wrapper classes because each one is 
named after the primitive type it wraps, but with 
the first letter capitalized to follow the class naming 
convention. 


Oh yeah, for reasons absolutely nobody on the 
planet is certain of, the API designers decided not 
to map the names exactly from primitive type to 
class type. You'll see what we mean: 


Boolean 

Character 

hie Watch out! The names arent 

Short mapped exactly to the primitive 
types. The class names are ully 

magar spelled out. 

Long 

Float 

aSa Give the primitive to the wrap- 


per constructor. That’s it- 
wrapping a value 
int i = 288; 
Integer iWrap = new Integer (i); 
All the wrappers work 
like this. Boolean has a 


booleanValuel), Character 


unwrapping a value has a CharValue(), ete. 
int unWrapped = iWrap.intValue () ; 
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primitive 


When you need to treat 
a primitive like an object, 
wrap it. 


Note: the picture at the top is a chocolate in a foil wrapper. Get 
it? Wrapper? Some people think it looks like a baked potato, but 
that works too. 
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This is stupid. You mean I can't 
just make an ArrayList of ints??? I 
have to wrap every single frickin’ one in a new 
Integer object and then unwrap it when I 

try to access that value in the ArrayList? 
That's a waste of time and an error 
waiting to happen... 


Java will Autobox primitives for you 


In The Olden Days (pre~Java 5), we did have to do all this ourselves, manually 
wrapping and unwrapping primitives. Fortunately, now it’s all done for us 


automatically. 


Let’s see what happens when we want to make an ArrayList to hold ints. 


An ArrayList of primitive ints 


Make an ArrayList of type Integer: 


public void autoboxing() { 
int x = 32; 4 
ArrayList<Integer> list = new ArrayList<Integer> () ; 
tist add0o; Just aaa itl Although there is NOT a method in ArrayList 


for add(int), the compiler does all the wrapping 
(boxing) for you. In other words, there really IS 
} an Integer object stored in the ArrayList, but 
Ard the teonact l you get to “pretend” that the ArrayList takes 
the Inte pia automatically unwraps lunboxes) ints. (You can add both ints and Integers to an 
divecthy de a 936E, 52 You ĉan assign the int value _ AvrayList<Integer>) 

int Val Y, a Primitive without having to eall th 

aluel) method on the Integer objeet e 


int num = list.get (0); 


there, are no ` 
, Dumb Questions 


Why not declare an ArrayList<int> if you want to hold ints? 


Å: Because...you can’t. At least, not in the versions of Java this book covers (the language 
is constantly evolving and things may change!). Remember, the rule for generic types is that 
you can specify only class or interface types, not primitives. So ArrayList<int> will not com- 
pile. But as you can see from the code above, it doesn’t really matter, since the compiler lets 
you put ints into the ArrayList<Integer>. In fact, there's really no way to prevent you from 
putting primitives into an ArrayList where the type of the list is the type of that primitive’s 
wrapper, since autoboxing will happen automatically. So, you can put boolean primitives in 
an ArrayList<Boolean> and chars into an ArrayList<Character>. 
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Autoboxing works almost everywhere 


Autoboxing lets you do more than just the obvious wrapping and 
unwrapping to use primitives in a collection...it also lets you use either 
a primitive or its wrapper type virtually anywhere one or the other is 
expected. Think about that! 


Fun with autoboxing 


Method arguments 3 


If a method takes a wrapper type, you u 


can pass a reference to a wrapper or = 
% OA int 
feger os, [ 


a primitive of the matching type. And 
of course the reverse is true—if a 
void takeNumber (Integer i) { } 


method takes a primitive, you can 
pass in either a compatible primitive 
or a reference to a wrapper of that 
primitive type. 


Return values int giveNumber() { 
If a method declares a primitive return x; 
return type, you can return either a } 
compatible primitive or a reference I 
to the wrapper of that primitive type. 
And if a method declares a wrapper 
return type, you can return either a 
reference to the wrapper type or a 


Ý oS 

primitive of the matching type. Sger © int 
Boolean expressions true 

Any place a boolean value is expected, 

you can use either an expression & 

that evaluates to a boolean (4 > 2), a COkean ANA boolean 

primitive boolean, or a reference to a 

Boolean wrapper. 

if (bool) { 
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System.out.printin("true"); 
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Operations on numbers 


This is probably the strangest one—yes, 
you can use a wrapper type as an operand 

in operations where the primitive type is 
expected. That means you can apply, say, 
the increment operator against a reference 
to an Integer object! 


But don't worry—this is just a compiler trick. 


The language wasn't modified to make the 
operators work on objects; the compiler 
simply converts the object to its primitive 
type before the operation. It sure looks 
weird, though. 


Integer i = new Integer(42); 


i++; 
And that means you can also do things like: 


Integer j = new Integer(5); 
Integer k = j + 3; 


3 
wae U 
OU 
reger oes int 


i++; 


Assignments 


You can assign either a wrapper or primitive 
to a variable declared as a matching wrapper 
or primitive. For example, a primitive int 
variable can be assigned to an Integer 
reference variable, and vice versa—a 
reference to an Integer object can be 
assigned to a variable declared as an int 
primitive. 


A 
me U 
feger OOS 


int 


Integer intVal = x; 


G harpen our pencil 
a y 


Will this code compile? Will it run? If it runs, 
what will it do? 


Take your time and think about this one; it 
brings up an implication of autoboxing that 
we didn’t talk about. 


You'll have to go to your compiler to find 
the answers. (Yes, we're forcing you to 
experiment, for your own good, of course.) 


—+> Yours to solve. 


public class TestBox { 
private Integer i; 
private int j; 


public static void main(String[] args) { 
TestBox t = new TestBox() ; 
t.go(); 

} 


public void go() { 
j =i; 
System. out .printin (j); 
System.out.printin (i); 
} 
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But wait! Theres more! Wrappers 
have static utility methods too! 


Besides acting like a normal class, the wrappers have a bunch 
of really useful static methods. 


For example, the parse methods take a String and give you 
back a primitive value. 

Method in the Integer 
Class that knows how to 
parse a String into the 


are’ 
Integer int it represents. 


my y 
Integer.parseInt (“3”) 


Takes a String 


Converting a String toa No problem to parse 
primitive value is easy: “D into 2- 
String s = "2"; 4 


int x = Integer .parseInt (s); 
double d = Double.parseDouble ("420.24"); 


boolean b = Boolean.parseBoolean ("True"); 


But if you try to do this: 


String t = "two"; 
int y = Integer .parseInt (t); 


Uh-oh. This compiles just Fine, but 
a at runtime it blows up. Anything 
that can’t be parsed as a number 


will cause a NumberFormatException. 


You'll get a runtime exception: 


File Edit Window Help Clue 
% java Wrappers 


Exception in thread "main" 
For input string: "two" 


java.lang.NumberFormatException: 


at java.base/java.lang.NumberFormatException.forInputStri 
ng (NumberFormatException. java: 65) 


at java.base/java.lang.Integer.parseInt (Integer. java: 652) 


at java.base/java.lang.Integer.parseInt (Integer. java:770) 


at Snippets.badParse (Snippets. java: 48) 
at Snippets.main(Snippets.java:54) 
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Every method or 
constructor that parses 
a String can throw a 
NumberFormatException. 
It’s a runtime exception, 
so you don’t have to 
handle or declare it. 

But you might want to. 


(We'll talk about exceptions in 
Chapter 13, Risky Behavior.) 
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And now in reverse..turning a 
primitive number into a String 


You may want to turn a number into a String, for example when you want to show this 
number to a user or put it into a message. There are several ways to turn a number into 


a String. The easiest is to simply concatenate the number to an existing String. i 
overloaded in 


tp ator is 
Rennie et pean 3 


double d = 42.5; V N Java (the only o tor Anything added to a 
String doubleString = "" + d; String tontatend ae ied. 
String becomes Stringiti 
double d = 42.5; eo Another way to do it POPE ET 


String doubleString = Double.toString (d); method in class Double. 


Hare Rae ae There’s also an overloaded a statit method 
String doubleString = String.valueOf (d); “glued p öh String that will get the 
String value of pretty much anything: 


Yeah, 
but how do I make 

it look like money? With a 
dollar sign and two decimal 
places like $56.87 or what if I 

want commas like 45,687,890 
or what if I want it in... 


Where's my printf 
like I have in C? Is 

number formatting part of 
the I/O classes? 
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Number formatting 


In Java, formatting numbers and dates doesn’t have to be coupled with I/O. Think about it. 
One of the most typical ways to display numbers to a user is through a GUI. You put Strings 
into a scrolling text area, or maybe a table. If formatting was built only into print statements, 
you'd never be able to format a number into a nice String to display in a GUI. 


The Java API provides powerful and flexible formatting using the Formatter class in java.util. 
But often you don’t need to create and call methods on the Formatter class yourself, because 
the Java API has convenience methods in some of the I/O classes (including printf{)) and 
the String class. So it can be a simple matter of calling a static String.format() method and 
passing it the thing you want formatted along with formatting instructions. 


Of course, you do have to know how to supply the formatting instructions, and that takes 
a little effort unless you’re familiar with the printf) function in C/C++. Fortunately, even 
if you don’t know printf(), you can simply follow recipes for the most basic things (that we’re 
showing in this chapter). But you will want to learn how to format if you want to mix and 
match to get anything you want. 


We'll start here with a basic example and then look at how it works. (Note: we’ll revisit 
formatting again in Chapter 16, Saving Objects.) 


Making big numbers more readable with underscores, a quick detour 


Before we get into formatting numbers, let’s take a small, useful detour. Sometimes you'll 
want to declare variables with large initial values. Let’s look at three declarations that assign 
the same large value, a billion, to long primitives: 


voperly located 
long hardToRead = 1000000000; TE you're assigning large values, properly 


~ : > v life easier: 
long easierToRead = 1_000_000_000; Ca underscores will make you 
long legalButSilly = 10_0000_0000; 


Formatting a number to use commas 
The number to format (we 


public class TestFormats { want it to have tommas). 


public static void main(String[] args) { 
long myBillion = 1_000_000_000; 
String s = String. format ("%,d", myBillion) ; 


A mau O a a 
System.out.println(s); cm Gia 


instructions for how to format 


j U s Case is an int 
re on 
i aw l ET i Te PA pe the biet toma EN 
| 1,000,000,000 | eral, so it isn’ i 

i SN n isn ¢ Separating arguments 


Now we get Commas inserted into the numb 
umber. 
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Formatting deconstructed... 


At the most basic level, formatting consists of two main parts (there is 
more, but we’ll start with this to keep it cleaner): 


©) Formatting instructions 


You use special format specifiers that describe how 


the argument should be formatted. Note: if you already know printf O 


[rom CHA you tan probably jut 
Mm . j a 
@) The argument to be formatted. trom oe nent ew Paes 


vead carefully! 
Although there can be more than one argument, we'll 


start with just one. The argument type can’t be just 
anything...it has to be something that can be formatted 
using the format specifiers in the formatting instructions. 
For example, if your formatting instructions specify a 
floating-point number, you can’t pass in a Dog or even 
a String that looks like a floating-point number. 


Do this- to this. 
© © 


format ("%,d", 1_000_000_000) ; 
Oona ee 


Use these instructions...on this argument. 


What do these instructions actually say? 


“Take the second argument to this method, and format it 


as a decimal integer and insert commas.” 


How do they say that? 


On the next page we’ll look in more detail at what the syntax “%,d” 
actually means, but for starters, any time you see the percent sign (%%) 
in a format String (which is always the first argument to a format() 
method), think of it as representing a variable, and the variable is the 
other argument to the method. The rest of the characters after the 
percent sign describe the formatting instructions for the argument. 
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the format() method 


The percent (Z) says, “insert argument here” 
(and format it using these instructions) 


The first argument to a format() method is called the format String, and it can 
actually include characters that you just want printed as-is, without extra formatting. 
When you see the % sign, though, think of the percent sign as a variable that 
represents the other argument to the method. 


More th 
ast icky i ore Characters to 


inélude in the Styi 
Characters to intlude in d serie on to the he second cd aii 
the final String veturned method (the number). ormatted and inserted. 


matl). 
from forma BY ne 4 


P S 


firgument to be 


ormatted. 


m~ A Ca 
String.format("I have %.2f, bugs to fix.", 476578.09876) ; 
Qn! 


/ 


output I have 476578.10 bugs to fix. 


Notice l 
ie eta Some of the numbers af_ 


the “2p” aa ie Can you Juess what 


The “%” sign tells the formatter to insert the other method argument (the second 
argument to format(), the number) here, AND format it using the “.2f” characters 
after the percent sign. Then the rest of the format String, “bugs to fix,” is added 
to the final output. 


Adding a comma 


String.format ("I have %,.2f bugs to fix.", 476578.09876); 


I have 476,578.10 bugs to fix. 


chanai 9 format instructions 
ila me) ” bo h, LẸ”, we got a 
Comma in the formatted number. 
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But how does it even KNOW 
where the instructions end and the 
rest of the characters begin? How come it 
doesn't print out the “f" in "%.2f"? Or the 
“2"? How does it know that the .2f was 
part of the instructions and NOT 
part of the String? 


The format String uses its 
own little language syntax 


You obviously can’t put just anything after the “°%o” 
sign. The syntax for what goes after the percent 
sign follows very specific rules, and describes how to 
format the argument that gets inserted at that point 
in the result (formatted) String, 


You’ve already seen some examples: 


%,d means “insert commas and format the number 
as a decimal integer.” 


and 


% .2f means “format the number as a floating point 
with a precision of two decimal places.” 


and 


%,.2£ means “insert commas and format the 
number as a floating point with a precision of two 
decimal places.” 


Really the question 1s: “How do I know what to put 
after the percent sign to get it to do what I want?” 
And that includes knowing the symbols (like “d” 

for decimal and “f” for floating point) as well as 

the order in which the instructions must be placed 
following the percent sign. For example, if you put 
the comma after the “qd” like “°/d,” instead of “°%,d” 
it won’t work! 


Or will it? What do you think this will do: 


String. format("I have %.2f, bugs to fix.", 476578.09876) ; 


(We'll answer that on the next page.) 
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The format specifier 


Everything after the percent sign up to and including the type indicator (like “d” 

or “f”) is part of the formatting instructions. After the type indicator, the formatter 
assumes the next set of characters is meant to be part of the output String, until or 
unless it hits another percent (%%) sign. Hmmmm...is that even possible? Can you have 
more than one formatted argument variable? Put that thought on hold for right now; 
we'll come back to it in a few minutes. For now, let’s look at the syntax for the format 


specifiers—the things that go after the percent (%) sign and describe how the argument 
should be formatted. 


A format specifier can have up to five different parts (not 
including the “%”). Everything in brackets [ ] below is optional, so 
only the percent (%) and the type are required. But the order is 
also mandatory, so any parts you DO use must go in this order. 


% [argument number] [flags] [width] — 


We'll get to this later... sd This defines the MINI- You Sey know ae is mandatory 
it le You say WHICH These are for spetia MUM number of char- this one---t defines i the r page) 
argument if £here’s more Formatting options acters that will be used. the precision: | In and will usually ly be 
han one. (Don’t peas) like mserting commas; That’s *minimum* not other words, ï «q” for a detimal 
about it Just yet.) putting n negative TOTAL. If the number sets the number integer or “P” Lor 
numbers in paren- is E than the width, of ae ia à floating-point 


theses, oF r it'll still be used in full, Dont £ orget, 
the numbers le but if it’s less than the intlude the - n 
justified. width, it'll be padded there. 


with zeros. 


number. 


%[argument number] [flags] [width] [.precision]type 


N 


format ("%,6.1f", 42. E 


There’s no ia value WC k- 
Jument number” p> Lord 
specified i this Lon, grit Ob ant: 
but all fie oika rmat String, W ote nor 


Pieces are thong 
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The only required specifier is for TYPE 


Although type is the only required specifier, remember that if you do put in 
anything else, type must always come last! ‘There are more than a dozen different 
type modifiers (not including dates and times; they have their own set), but most 
of the time you'll probably use “od (decimal) or %f (floating point). And typically 
you'll combine %f with a precision indicator to set the number of decimal places 
you want in your output. 


The TYPE is mandatory, everything else is optional. You must include a 
type in your format 
%d decimal vo A reg would not workl j4 J P y l 
format ("%d", 42); hs e the same as +. ia do instructions, and if you 
assi 
a vee he specify things besides 
The argument must be compatible with an int, so that means only type ; the type must 


byte, short, int, and char (or their wrapper types). 


always come last. 
the “ ç” 


%f floating point Here we Combined cee M ost o f th e time, 


f "%.3£", 42.000000 ith a precision indita 
ormat ( ) vt es L ended uP with 


Hycen eer you'll probably format 


numbers using either 


The argument must be of a floating-point type, so that means a Wes sens 
only a float or double (primitive or wrapper) as well as something d for decimal or f 
called BigDecimal (which we don’t look at in this book). 


for floating point. 


%Xx hexadecimal 
format ("%x", 42) 


The argument must be a byte, short, int, long (including both 
primitive and wrapper types), and BigInteger. 


%c character 
format ("Se", 42) The number AL represents 


A CO 


The argument must be a byte, short, char, or int (including both 
primitive and wrapper types). 
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What happens if I have more than one argument? 


Imagine you want a String that looks like this: 
“The rank is 20, 456,654 out of 100,567,890. 24.” 


But the numbers are coming from variables. What do you do? You simply add two arguments 
after the format String (first argument), so that means your call to format() will have three 
arguments instead of two. And inside that first argument (the format String), you'll have two 
different format specifiers (two things that start with “%o”). The first format specifier will insert 
the second argument to the method, and the second format specifier will insert the third 
argument to the method. In other words, the variable insertions in the format String use the 
order in which the other arguments are passed into the format() method. 


int one = 20456654; 
double two = 100567890.248907; 


String s = 


ee, 


The rank is 20,456,654 out of 100,567,890.25 argument, they’ 
k 2 The’ 
d 


We added tommas to both variables and 
restricted the floating-point number (the 
second variable) to two decimal places. 


As you'll see when we get to date formatting, you might actually want to apply different 
formatting specifiers to the same argument. That’s probably hard to imagine until you see how 
date formatting (as opposed to the number formatting we’ve been doing) works. Just know that in 
a minute, you'll see how to be more specific about which format specifiers are applied to which 
arguments. 


there are no 


Dumb Questions 


- Um, there’s something REALLY strange going on here. Just how many arguments can | 
pass? | mean, how many overloaded format() methods are IN the String class? So, what happens 
if | want to pass, say, ten different arguments to be formatted for a single output String? 


A: Good catch. Yes, there is something strange going on, and no there are not a bunch of 
overloaded format() methods to take a different number of possible arguments. In order to support 
this formatting (printf-like) API in Java, the language needed another feature—variable argument 
lists (called varargs for short). We'll talk about varargs more in Appendix B. 
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String.format ("The rank is %,d@ out of %,.2£", one, two); 


Y re inserted 
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Just one more thing...static imports 


Static imports are a real mixed blessing. Some people love this idea, 

some people hate it. Static imports exist to make your code a little 

shorter. If you hate to type or hate long lines of code, you might just 

like this feature. The downside to static imports is that—if you’re Use carefully: 


not careful—using them can make your code a lot harder to read. 


The basic idea is that whenever you’re using a static class, a static Static impor ts can 
variable, or an enum (more on those later), you can import them make your code 


and save yourself some typing. 


confusing to read. 


Always re-read 
your code after 
class NoStatic { using a static import 
public static void main(String[] args) { and think: "Wil I 
understand this in 
six months time?” 


Without static imports: 


System.out.println ("sqrt " + Math.sqrt(2.0)); 


System.out.println("tan " + Math.tan(60)); 


wine” 
} The oyna ak weno 
S 
Same code, with static imports: ra getiaen 


import static java.lang.Math.*; Caveats & Gotchas 


quport Statice: java: lang System out; = Using a static import removes the information 


class WithStatic { about which class the static came from. We'd 
advise using static imports only when the static 
public static void main(String[] args) { method or variable still means something 


when it’s not prefixed with the class name. 
out.printin("sqrt " + sqrt(2.0)); 


f ks m 
t intln ("t " + tan(60)) chat igo“ = A big issue with static imports is that 
out.printin an an ; 


ator it's easy to create naming conflicts. For 
} ji ence example, if you have two different classes 
eeto ‘ou might want to use with an “add()’ method, how will you and 
bk pe 8 BA Removint) Y i be Dede et: for these the compiler know which one to use? So 
This "IN gore uncles Y hiso tod s- It makes the it's best not to use a static import if it’s 
s S Krom- £ shorter, and you possible to create a conflict. 


eS ia 
os cor ed he “Math.” | idcard (°), 
ko rare yariddes ix to understand NOTES nat Yalan nag ween sp 
what these operations are. your static import declaration. 
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Fireside Chats 
” g 
à a + 


Instance Variable 

I don’t even know why we’re doing this. Everyone 
knows static variables are just used for constants. 
And how many of those are there? I think the 
whole API must have, what, four? And it’s not like 
anybody ever uses them. 


Full of it. Yeah, you can say that again. OK, so 
there are a few in the Swing library, but everybody 
knows Swing is just a special case. 


Ok, but besides a few GUI things, give me an 
example of just one static variable that anyone 
would actually use. In the real world. 


Well, that’s another special case. And nobody uses 
that except for debugging anyway. 
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Tonight’s Talk: An instance variable 
takes cheap shots at a static variable 


Static Variable 


You really should check your facts. When was the 
last time you looked at the API? It’s frickin’ loaded 
with statics! It even has entire classes dedicated 

to holding constant values. ‘There’s a class called 
SwingConstants, for example, that’s just full of 
them. 


It might be a special case, but it’s a really 
important one! And what about the Color class? 
What a pain if you had to remember the RGB 
values to make the standard colors! But the color 
class already has constants defined for blue, 
purple, white, red, etc. Very handy. 


How’s System.out for starters? The out in System. 
out is a static variable of the System class. You 
personally don’t make a new instance of the 
System; you just ask the System class for its out 
variable. 


Oh, like debugging isn’t important? 


And here’s something that probably never crossed 
your narrow mind—let’s face it, static variables 
are more efficient. One per class instead of one 
per instance. The memory savings might be huge! 


Instance Variable 


Um, aren’t you forgetting something? 


Static variables are about as un-OO as it gets!! 
Gee, why not just go take a giant backward step 
and do some procedural programming while 
we're at it. 


You're like a global variable, and any programmer 
worth their sticker-covered laptop knows that’s 
usually a Bad Thing. 


Yeah, you live in a class, but they don’t call it 
Class-Oriented programming. That’s just stupid. 
You're a relic. Something to help the old-timers 
make the leap to Java. 


Well, OK, every once in a while sure, it makes 
sense to use a static, but let me tell you, abuse of 
static variables (and methods) is the mark of an 
immature OO programmer. A designer should be 
thinking about object state, not class state. 


Static methods are the worst things of all, because 
it usually means the programmer is thinking 
procedurally instead of about objects doing things 
based on their unique object state. 
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Static Variable 


What? 


What do you mean uwn-OO? 


Iam NOT a global variable. There’s no such 
thing, I live in a class! That’s pretty OO you know, 
a CLASS. Pm not just sitting out there in space 
somewhere; I’m a natural part of the state of an 
object; the only difference is that I’m shared by all 
instances of a class. Very efficient. 


Alright just stop right there. THAT is definitely 
not true. Some static variables are absolutely 
crucial to a system. And even the ones that aren’t 
crucial sure are handy. 


Why do you say that? And what’s wrong with 
static methods? 


Sure, I know that objects should be the focus of 
an OO design, but just because there are some 
clueless programmers out there...don’t throw the 
baby out with the bytecode. There’s a time and 
place for statics, and when you need one, nothing 
else beats it. 
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be the compiler 


BE the Compiler 


The Java file on this page represents a 
complete program. Your job is to play 
compiler and determine whether this 
file will compile. If it wort compile, 
how would you fix it? When 
it runs, what would be its 
output? 


class StaticSuper { 
static { 
System.out.printin("super static block"); 


Which of these is the output? 


StaticSuper () { 
System.out.printin("super constructor"); 
} Possible Output 


Sjava StaticTests 
public class StaticTests extends StaticSuper { Aig Mics: A 


static int rand; ne maia 
super static block 


static { super constructor 
rand = (int) (Math.random() * 6); 


System.out.printin("static block " + rand); 


constructor 


StaticTests() { 


System.out.printin("constructor"); 
Possible Output 


File Edit Window Help Electricity 


: : . . . %java StaticTests 
public static void main(String[] args) { 
i R i super static block 
System.out.println("in main"); 

, 9 static block 3 
StaticTests st = new StaticTests(); : A 
in main 


super constructor 


constructor 


——— > Answers on page 308. 
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This chapter explored the wonderful, static world 
of Java. Your job is to decide whether each of the 
following statements is true or false. 


© Trve or Farse $ 


1. To use the Math class, the first step is to make an instance of it. 

2. You can mark a constructor with the static keyword. 

3. Static methods don’t have access to instance variable state of the “this” object. 
4. It is good practice to call a static method using a reference variable. 
5. Static variables could be used to count the instances of a class. 

6. Constructors are called before static variables are initialized. 

7. MAX_SIZE would be a good name for a static final variable. 

8. A static initializer block runs before a class’s constructor runs. 

9. If a class is marked final, all of its methods must be marked final. 

10. A final method can be overridden only if its class is extended. 

11. There is no wrapper class for boolean primitives. 

12. A wrapper is used when you want to treat a primitive like an object. 
13. The parseXxx methods always return a String. 


14. Formatting classes (which are decoupled from I/O) are in the java.format package. 


—— Answers on page 308. 
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Exercise Solutions 


oer your pencil (from page 287) 


1,4, 5, and 6 are legal. 


2 doesn't compile because the static 
method references a non-static instance 
variable. 


3 doesn't compile because the instance 
variable is final but hasn't been initialized. 


BE the Compiler 


(from page 306) 


StaticSuper l) í 
System.out.println ( 


"super constructor"); 


StaticSuper is a constructor and must 
have ( ) in its signature. Notice that as 
the output below demonstrates, the static 
blocks for both classes run before either 
of the constructors run. 


pis will be 343°" 
Note Oa ated none fee 


Output O ko 6 wnclusive- 


File Edit Window Help Cling i= | 


S$java StaticTests 


super static block 
static block 3 

in main 

super constructor 


constructor 
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Trve oR Fatse (from page 307) 


1. To use the Math class, the first step is to make 
an instance of it. 

2. You can mark a constructor with the keyword 
“static.” 

3. Static methods don’t have access to an object’s 
instance variables. 

4. It is good practice to call a static method using a 
reference variable. 

5. Static variables could be used to count the in- 
stances of a class. 

6. Constructors are called before static variables 
are initialized. 

7. MAX_SIZE would be a good name for a static 
final variable. 

8. A static initializer block runs before a class’s 
constructor runs. 

9. If a class is marked final, all of its methods must 
be marked final. 

10. A final method can be overridden only if its 
class is extended. 

11. There is no wrapper class for boolean primi- 
tives. 

12. A wrapper 1s used when you want to treat a 
primitive like an object. 

13. The parseXxx methods always return a String. 
14. Formatting classes (which are decoupled from 


I/O) are in the java.format package. 


False 


False 


True 


False 


True 


False 


True 


True 


False 


False 


False 


True 


False 


False 
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Data Structures 


Sheesh...and all 
this time I could have 
just let Java put things in 
alphabetical order? Third 
grade really sucks. We never 
learn anything useful... 


Sorting isa snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms (unless you're reading this right 
now sitting in your Computer Science 101 class, in which case, trust us—you are SO going to be 
writing sort code while the rest of us just call a method in the Java API). In this chapter, you're 
going to get a peek at when Java can save you some typing and figure out the types that you 


need. 


The Java Collections Framework has a data structure that should work for virtually anything 
you'll ever need to do. Want to keep a list that you can easily keep adding to? Want to find 
something by name? Want to create a list that automatically takes out all the duplicates? Sort 
your co-workers by the number of times they’ve tried to speak with their mic muted on a video 


call? Sort your pets by number of tricks learned? It’s all here... 
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sorting a list 


Tracking song popularity on your jukebox 


Congratulations on your new job—managing the automated 


jukebox system at Lou’s Diner. There’s no Java inside the jukebox 
itself, but each time someone plays a song, the song data is 
appended to a simple text file. 


Your job is to manage the data to track song popularity, 

generate reports, and manipulate the playlists. You’re not writing the entire app—some of the 
other software developers are involved as well, but you’re responsible for managing and sorting 
the data inside the Java app. And since Lou has a thing against databases, this is strictly an in- 
memory data collection. Another programmer will be writing the code to read the song data 
from a file and put the songs into a List. (In a few chapters you'll learn how 

to read data from files, and write data to files.) All you’re going to get is a 


? ° 
List with the song data the jukebox keeps adding to. You ll often want to write 
Let’s not wait for that other programmer to give us the actual file of some temporary code that 
songs; let’s create a small test program to provide us with some sample i 
data we can work with. We’ve agreed with the other programmer that stands m for the real code 


she’ll ultimately provide a Songs class with a getSongs method we'll use to that will come later This iS 


get the data. Armed with that information, we can write a small class to 
temporarily “stand in” for the actual code. Code that stands in for other called “mocking ki 


code is often called “mock” code. 


e'll re 
We'll make this pies statit, 
because this elass doesn r | 
— eCause ArrayList IS-A Li 
a i ; ist, we ĉan ĉr 
class peis a Hoesen’ need any: an ArrayList, store it in a List, and aa 


List from the method. 
In the veal world you'll often see Java code 


public static List<String> getSongStrings() { 


List<String> songs = new ArrayList<>() ; that r i 
songs .add ("somersault"); hid eturns the interface type (List) and 
" aan Ides the Im lem tati 
songs .add ("cassidy"); P en 1on type (Avra List) 
songs .add ("$10"); This wil 7 l 
songs. add ("havana") : to nr be our |; T. 
songs .add ("Cassidy"); with, of six 5 
songs.add("50 Ways"); ong titles 
return songs; 
} 
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Your first job, sort the songs in alphabetical order 


We'll start by creating code that reads in data from the mock Songs class and prints 
out what it got. Since an ArrayList’s elements are placed in the order in which they 
were added, it’s no surprise that the song titles are not yet alphabetized. 


import java.util.*; 


public class Jukeboxl { 
public static void main(String[] args) { f a 
new Jukebox1().go(); We'll store the song titles in 


| ro List of Strings- 
public void go() { 


List<String> songList = MockSongs.getSongStrings (); 
System. out .printi1n(songList) ; 


Then pri 
i <— aa 


// Below is the "mock" code. A stand in for the actual 
// I/O code that the other programmer will provide later 


class MockSongs { 
public static List<String> getSongStrings() { 

List<String> songs = new ArrayList<>(); le data we 

songs.add("somersault") ; N thi 9 special here.-.just io Se 
i in i ode- 

songs .add ("cassidy"); o our sortmg 

songs.add("$10"); can use andl 

songs .add ("havana"); 

songs .add ("Cassidy"); 

songs.add("50 Ways"); 

return songs; 


% java Jukebox1 
[somersault, cassidy, $10, havana, 
Cassidy, 50 Ways] 


è . \l 
e— This is definitely NOT alphabetical: 
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the diamond operator 


Before we get onto sorting, 
T have a question about the way the songDB 
ArrayList was declared on the last page. Normally, 
you have to put the type of the object in the 

ArrayList inside angle brackets on both sides of the 
equals sign. But on the last page, there was an empty 
set of brackets on the right-hand side. Is this 
special syntax? 


Great question! You spotted the diamond operator 


So far, we’ve been declaring our ArrayLists by showing the element type twice: 


ArrayList<String> songs = new ArrayList<String>() ; 


Most of the time, we don’t need to say the same thing twice. The compiler can 
tell from what you wrote on the left-hand side what you probably want on the 
right-hand side. It uses type inference to infer (work out) the type you need. 


ArrayList<String> songs = new an ee No type needed 


This syntax is called the diamond operator (because, well, it’s diamond-shaped!) 
and was introduced in Java 7, so it’s been around a while and is probably 
available in your version of Java. 


Over time, Java has evolved to remove 
unnecessary code duplication from its 
syntax. If the compiler can figure out 
a type, you don’t always need to write 
it out in ful]. 
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there, are_no 


Dumb Questions 


+ Should Ibe using the diamond operator all 
the time? Are there any downsides? 


A: The diamond operator is “syntactic sugar,” which 
means it’s there to make our lives easier as we write 
(and read) code, but it doesn’t make any difference to 
the underlying byte code. So if you're worried about 
whether using the diamond means something differ- 
ent to using the specific type, don’t worry! It’s basically 
the same thing. 


However, sometimes you might choose to write out 
the full type. The main reason you might want to is 

to help people reading your code. For example, if the 
variable is declared a long way from where it’s initial- 
ized, you might want to use the type when you initial- 
ize it so you can see clearly what objects go into it. 


ArrayList<String> songs; 
// lots of code between these lines... 


songs = new ArrayList<String>() ; 


Q: Are there any other places the compiler can 
work out the types for me? 


A: Yes! For example, the var keyword (“Local 
Variable Type Inference”), which we'll talk about in 
Appendix B. And another important example, lambda 
expressions, which we will see later in this chapter. 


collections with generics 


Q: I saw you were creating an ArrayList 
but assigning it to a List reference, and that 
you created an ArrayList but returned a List 
from the method. Why not just use ArrayList 
everywhere? 


A: One of the advantages of polymor- 
phism is that code doesn’t need to know the 
specific implementation type of an object to 
work well with it. List is a well-known, well- 
understood interface (which we'll see more of 
in this chapter). Code that is working with an 
ArrayList doesn’t usually need to know it’s an 
ArrayList. It could be a LinkedList. Or a special- 
ized type of List. Code that's working with the 
List only needs to know it can call List methods 
on it (like add(), size() etc). It's usually safer 

to pass the interface type (i.e., List) around 
instead of the implementation. That way, other 
code can't go rooting around inside your ob- 
ject in a way that was never intended. 


It also means that should you ever want to 
change from an ArrayList to a LinkedList, or a 
CopyOnWriteArrayList (see Chapter 18, Dealing 
with Concurrency Issues) at a later date, you can 
without having to change all the places the 
List is used. 
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ArrayList API 


Exploring the java.util API, List and Collections 


We know that with an ArrayList, or any List, the elements are kept in the order in which they were 
added. So we’re going to need to sort the elements in the song list. In this chapter, we’ll be looking 
at some of the most important and commonly used collection classes in the java.util package, but 

for now, let’s limit ourselves to two classes: java.util.List and java.util.Collections. 


We've been using ArrayList for a while now. Because ArrayList IS-A List and because many of the 


methods we’re familiar with on ArrayList come from List, we can comfortably transfer most of 
what we know about working with ArrayLists to List. 


The Collections class is known as a “utility” class. It’s a class that has a lot of handy methods for 
working with the various collection types. 


Excerpts from the API 


Si . 


java.util. Collections 


Si . 


7 


In the “Real-World’™ there are lots of ways to sort 


We don’t always want our lists sorted alphabetically. We might want to sort clothes by size, or 
movies by how many five-star reviews they get. Java lets you sort the good old-fashioned way, 
alphabetically, and it also lets you create your own custom sorting approaches. Those references you 


see above to “Comparator” have to do with custom sorting, which we'll get to later this chapter. So 
for now, let’s stick with “natural ordering” (alphabetical). 


Since we know we have a List, it looks like we’ve found the perfect method, Collections.sort/(). 
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“Natural Ordering,’ what Java means by alphabetical 


Lou wants you to sort songs “alphabetically,” but what exactly does that mean? The A-Z part 

is obvious, but how about lowercase versus uppercase letters? How about numbers and special 
characters? Well, this is another can-of-worms topic, but Java uses Unicode, and for many of us 

in “the West” that means that numbers sort before uppercase letters, uppercase letters sort before 
lowercase letters, and some special characters sort before numbers and some sort after numbers. 
That’s pretty clear, right? Ha! Well, the upshot is that, by default, sorting in Java happens in what’s 
called “natural order,” which is more or less alphabetical. Let’s take a look at what happens when 
we sort our list of songs: 


public void go() { 
List<String> songList = MockSongs.getSongStrings(); 
System.out.printlin(songLlist) ; Sort our song title 
Collections.sort (songList) ; L~ “hatural ordering, 
System.out.printin(songList) ; 

} 


s using, 


Our songs unsorted» 


5 he 
in the order they 


%java Jukebox1 y were added. 


[somersault, cassidy, $10, havana, Cassidy, 50 Ways] 


[$10, 50 Ways, Cassidy, cassidy, havana, somersault] e~ 


Our Songs sorted. 
Notice how the special 
characters, numbers, 


and uppercase letters 
got sorted. 


Just FYI, we ducks are 
very particular about how we 
get sorted. 
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sorting your own objects 


But now you need Song objects, not just simple Strings 


Now your boss Lou wants actual Song class instances in the list, not just Strings, so that each Song can 
have more data. The new jukebox device outputs more information, so the actual song file will have 


three pieces of information for each song. 


The Song class is really simple, with only one interesting feature—the overridden toString() method. 
Remember, the toString() method is defined in class Object, so every class in Java inherits the method. 
And since the toString() method is called on an object when it’s printed (System.out.println(anObject)), 
you should override it to print something more readable than the default unique identifier code. When 
you print a list, the toString() method will be called on each object. 


class Songv2 { 
private String title; 
private String artist; 
private int bpm; 


T hree instance 
three song at 


SongV2 (String title, 
this.title title; 
this.artist artist; 
this.bpm bpm; 


String artist, 


public String getTitle() { 
return title; 


The 


public String getArtist() { the 


return artist; 


public int getBpm() { 
return bpm; 


public String toString() { 
return title; 


} 


class MockSongs { 
public static List<String> getSongStrings () 


public static List<SongV2> getSongsv2() { 
List<SongV2> songs new ArrayList<>(); 
songs.add(new Songv2("somersault", "zero 
songs.add(new SongV2 ("cassidy", 
songs.add(new SongV2("$10", "hitchhiker", 


songs .add (new "cabello", 
songs .add (new 
songs .add (new 


return songs; 


SongV2 ("havana", 
SongV2 ("Cassidy", 


Songv2 ("50 ways", "simon", 


} 
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ables for the 
roe in the file- 


int bpm) { 


a seas 


osea jf 


7", 147) 


"grateful dead", 


140)); 


105)); 


"grateful dead", 


102)); 


The variables ave all set in 
the constructor whenever 
a new Song is created. 


etter methods for 
Nae attributes. 


hen YOu do 


se W 
(), betau we wan 


Wi 
rie ae Sy stem.out- 


th the foString) 
ist. 


We made a new method in 
the MotkSongs class to 
mock the new song data. 


); 
158)); 
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Changing the Jukebox code to use Songs 
instead of Strings 


Your code changes only a little. The big change is that the List will be 
of type <SongV2> instead of <String>. 


import java.util.*; 


public class Jukebox2 { 
public static void main(String[] args) { 
new Jukebox2().go(); 
} Change to a List of Song 2- 
ci instead of Strings: 


objet 
public void go() { 


List<Songv2> songList = MockSongs.getSongsV2 () ; 


System.out.println(songList) ; RK call the motk elass to a 
` r Lis 

Collections.sort (songList) ; son) data into ou 

System.out.printin(songList) ; songs: 


} 


And once again, call the 
sort method to sort the 


songs. 


I'm curious to see how the 
Collections.sort() method is 
going to sort these songs. 
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Collections.sort() 


It wont compile! 


He’s right to be curious, something’s wrong...the Collections class clearly shows 
there’s a sort() method that takes a List. It should work. 


But it doesn’t! 


The compiler says it can’t find a sort method that takes a List<SongV2>, so 
maybe it doesn’t like a List of Song objects? It didn’t mind a List<String>, so 
what’s the important difference between Song and String? What’s the difference 
that’s making the compiler fail? 


| File Edit Window Help Bummer 
% javac Jukebox2. java 

Jukebox2.java:13: error: no suitable method found for 
sort (List<SongV2>) 


Collections .sort (songList) ; 
A 


1 error 


And of course you probably already asked yourself, “What would it be 
sorting on?” How would the sort method even know what made one Song 
greater or less than another Song? Obviously if you want the song’s title 
to be the value that determines how the songs are sorted, you'll need 
some way to tell the sort method that it needs to use the title and not, say, 
the beats per minute. 


We'll get into all that a few pages from now, but first, let’s find out why 
the compiler won’t even let us pass a SongV2 List to the sort() method. 
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What is this??? I have no 
idea how to read the method 
declaration on this. It says that 
sort() takes a List<T>, but what 
is T? And what is that big thing 
before the return type? 


The sort() method declaration 


static(<T extends Comparable<? super T>>) void oe) list) 
tie 


Sorts peCitied list into ascending order, 
according to the natural ordering of its elements. 


From the API docs (looking up the java.util.Collections class and scrolling to the sort() method), it looks 
like the sort() method is declared...strangely. Or at least different from anything we’ve seen so far. 


That’s because the sort() method (along with other things in the whole collection framework in Java) 
makes heavy use of generics. Any time you see something with angle brackets in Java source code or 
documentation, it means generics—a feature added in Java 5. So it looks like we'll have to learn how to 
interpret the documentation before we can figure out why we were able to sort String objects in a List, 
but not a List of Song objects. 
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generic types 


Generics means more type-safety 


Although generics can be used in other ways, you'll often use generics to 
write type-safe collections. In other words, code that makes the compiler 
stop you from putting a Dog into a list of Ducks. 


Without generics the compiler could not care less what you put into a 
collection, because all collection implementations hold type Object. You 
could put anything in any ArrayList without generics; it’s like the ArrayList 
is declared as ArrayList<Object>. 


oO 
Before generics) there was n 


£ an 
WITHOUT generics way to detlore PD etaed 
ASU) 
Objects go IN as a reference to Pir Object: 
SoccerBall, Fish, Guitar, and 


Car objects 


SOK ic 
TOMNI 


And come OUT as a reference of type Object 


WITH generics 


Objects go IN as a reference to 
only Fish objects 


+ + } 


X AERTS REPRE 
Y OE a OE N N 
ws Ree NK 


7 Goo 


Without generics, the 
compiler would happily let 
you put a Pumpkin into 
an ArrayList that was 
supposed to hold only Cat 
objects. 


With generics, you 

can create type-safe 
collections where more 
problems are caught at 
compile-time instead of 
runtime. 


And come out as a reference of type Fish 
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Learning generics 


Of the dozens of things you could learn about generics, there are 
really only three that matter to most programmers: 


© Creating instances of generic classes (like ArrayList) 


When you make an ArrayList, you have to tell it the type of new Peeayitseseongst) 


objects you'll allow in the list, just as you do with plain old 
arrays. 


@ Declaring and assigning variables of generic types 
—_ List<Song> songList = 

How does polymorphism really work with generic types? If you new ArrayList<Song> () 

have an ArrayList<Animal> reference variable, can you assign an 

ArrayList<Dog> to it? What about a List<Animal> reference? 

Can you assign an ArrayList<Animal> to it? You'll see... 


Declaring (and invoking) methods that take generic types 


If you have a method that has as a parameter, say, an ArrayList void foo(List<Song> list) 
of Animal objects, what does that really mean? Can you also 
pass it an ArrayList of Dog objects? We’ll look at some subtle x. foo (songList) 


and tricky polymorphism issues that are very different from the 
way you write methods that take plain old arrays. 


(This is actually the same point as #2, but that shows you how 
important we think it is.) 


there are no 


Dumb Questions 


Q: But don’t | also need to learn how to create my OWN generic 
classes? What if | want to make a class type that lets people 
instantiating the class decide the type of things that class will use? 


A: You probably won't do much of that. Think about it—the API 
designers made an entire library of collections classes covering most 
of the data structures you'd need, and the things that really need to be 
generic are collection classes or classes and methods that work on col- 
lections. There are some other cases too (like Optional, which we'll see 
in the next chapter). Generally, generic classes are classes that hold or 
operate on objects of some other type they don't know about. 


Yes, it is possible that you might want to create generic classes, but that’s 
pretty advanced, so we won't cover it here. (But you can figure it out 
from the things we do cover, anyway.) 
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Using generic CLASSES 


Since ArrayList is one of our most-used generic classes, we'll 
start by looking at its documentation. The two key areas to 
look at in a generic class are: 


1. The class declaration 


2. The method declarations that let you add elements 


Understanding ArrayList documentation 
(Or, what’s the true meaning of “E”?) 


\der for the Arra List 
pisa ylaceho ou yist is a subelass 
EAL tyre yov use wher Tykist ried ype You sree praetList 
\ave and ereate an if yList is autom all Y tor the 
det \ YPe of the Abstract) y “ed for th 
public class ArrayList<E> extends AbstractList<E> implements List<E> ... { 


blic bool dd(E 
ae The type (the value of <E>) 
becomes the type of the List 


Here’s the important part! Whatever “E” is teasel 


determines what kind of things you're allowed 
to add to the ArrayList: 


// more code 


Think of “F” as a stand- 


The “E” represents the type used to create an instance mn for “the type of element 
of ArrayList. When you see an “E” in the ArrayList 


documentation, you can do a mental find/replace to exchange you want this collection to 


. f . . ; f 
it for whatever <type> you use to instantiate ArrayList. hold and return.’ (E 1S for 
So, new ArrayList<Song> means that “E” becomes “Song” in = 

any method or variable declaration that uses “E.” Element.) 
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Using type parameters with ArrayList 


THIS code: 


List<String> thisList = new ArrayList<> 


Means ArrayList: 


public class ArrayList<E>|extends AbstractList<E> ... { 


public boolean add(E o) 
// more code 


Is treated by the compiler as: 


public class ArrayList<String> extends AbstractList<String>... { 


public boolean add(String o) 
// more code 


In other words, the “E” is replaced by the zeal type (also called the type parameter) that 
you use when you create the ArrayList. And that’s why the add() method for ArrayList 
won't let you add anything except objects of a reference type that’s compatible with 
the type of “E.” So if you make an ArrayList<String>, the add() method suddenly 
becomes add (String o). If you make the ArrayList of type Dog, suddenly the add() 
method becomes add(Dog o). 


thereareno  ; 
Dumb Questions 


Q: Is “E” the only thing you can put there? Because the docs for sort used “T”... 


A: You can use anything that’s a legal Java identifier. That means anything that you 
could use for a method or variable name will work as a type parameter. But you'll often 
see single letter used. Another convention is to use “T” (“Type”) unless you're specifically 
writing a collection class, where you'd use “E” to represent the “type of the Element the 
collection will hold.” Sometimes you'll see “R” for “Return type.” 


you are here > 
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generic methods 


Using generic METHODS 


A generic class means that the class declaration includes a type parameter. A 


generic method means that the method declaration uses a type parameter in 
its signature. 


You can use type parameters in a method in several different ways: 


@ 
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Using a type parameter defined in the class declaration 


public class ArrayList<E> extends AbstractList<E> ... { 


public boolean add(E o) Se Can use the “E” h 
a ready been defined > pein 


eCause it’s 


the elass. 
When you declare a type parameter for the class, you can 


simply use that type any place that you’d use a real class or 
interface type. The type declared in the method argument 
is essentially replaced with the type you use when you 
instantiate the class. 


Using a type parameter that was NOT defined in the 


class declaration i 


public <T extends Animal> void takeThing (ArrayList<T> list) 


If the class itself doesn’t use a type parameter, you can still Here 
specify one for a method, by declaring it in a really unusual (but 
available) space—before the return type. This method says that T declaration, 
can be “any type of Animal.” 
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a 
we Ts b 
the start of th 


> beCause we 
e method 


declared 
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Wait...that can't be right. If you can 
take a list of Animal, why don't you 

just SAY that? What's wrong with just 
takeThing(ArrayList<Animal> list)? 


Here's where it gets weird... 


This: 
public <T extends Animal> void takeThing(ArrayList<T> list) 


Is NOT the same as this: 
public void takeThing (ArrayList<Animal> list) 


Both are legal, but they’re different! 


The first one, where <T extends Animal> is part of the method 
declaration, means that any ArrayList declared of a type that is 
Animal, or one of Animal’s subtypes (like Dog or Cat), is legal. 

So you could invoke the top method using an ArrayList<Dog>, 
ArrayList<Cat>, or ArrayList<Animal>. 


But...the one on the bottom, where the method argument is 
(ArrayList<Animal> list) means that only an ArrayList<Animal> is 
legal. In other words, while the first version takes an ArrayList of any 
type that is a type of Animal (Animal, Dog, Cat, etc.), the second 
version takes only an ArrayList of type Animal. Not ArrayList<Dog> 
or ArrayList<Cat>, but only ArrayList<Animal>. 


And yes, it does appear to violate the point of polymorphism, but 
it will become clear when we revisit this in detail at the end of the 
chapter. For now, remember that we’re only looking at this because 
we're still trying to figure out how to sort() that SongList, and that 
led us into looking at the API for the sort() method, which had this 
strange generic type declaration. 


For now, all you need to know is that the syntax of the 
top version is legal and that it means you can pass in a 
ArrayList object instantiated as Animal or any Animal 
subtype. 


And now back to our sort() method... 


youarehere> 325 


sorting a Song 


This still doesn't explain why 
the sort method failed ona 
List of Songs but worked for a 
List of Strings... 


Remember where we were... 


| File Edit Window Help Bummer 
%javac Jukebox2. java 
Jukebox2.java:13: error: no suitable method found 
for sort (List<SongV2>) 

Collections.sort (songList) ; 


A 


import java.util.*; 


public class Jukebox2 { 
public static void main(String[] args) { 
new Jukebox2().go(); 
} 


public void go() { 


List<SongV2> songList = MockSongs.getSongsvV2 () ; 
System.out.printin(songList) ; 
e it breaks! [t worked Fine when ie 
Sy s soon as we Trt 
Collections.sort (songList) ; assed in a List<String>, get d 
System.out.println(songList) ; os List<SongV2>) ï 


This is wher 
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Revisiting the sort() method 


So here we are, trying to read the sort() method docs to find out why 
it was OK to sort a list of Strings, but not a list of Song objects. And 
it looks like the answer is... 


static(<T extends Comparable<? super T>> void sort(List<t} list) 
t A 


Sorts specified list into ascending order, 
according to the natural ordering of its elements. 


The sort() method can take only lists of Comparable objects. 


Song is NOT a subtype of Comparable, so you cannot sort() the 
list of Songs. 


At least not yet... 


public static <T extends Comparable<? super T>> void sort (List<T> list) 


me, f 


Ignore this part for now. But i 
n i PA . i ly a List lor 
i “Whatever ‘T’ is must yos tan t, it just mea You tan ee We i 
ie py re Carate that the type prance: Oe subtype oF lel e i 


meterized type 
Comparable must be of type T that uses a para eterized ty 
or one of T’s TAN i that “extends Comparable. 


Um...I just checked the docs for 
String, and String doesn't EXTEND 
Comparable—it IMPLEMENTS it. Comparable 
is an interface. So it's nonsense to say <T 
extends Comparable>. 


public final class String 


implements java.io.Serializable, Comparable<String>, CharSequence { 


Great point, and one that deserves a full answer! Turn the 
page... 
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extends or implements 


In generics, extends” means 
‘extends or implements” 


The Java engineers had to give you a way to put a constraint on a 
parameterized type so that you can restrict it to, say, only subclasses 


of Animal. But you also need to constrain a type to allow only classes In generics, the keyw ord 
that implement a particular interface. So here’s a situation where we “extends” really means “IŞ- A” 


need one kind of syntax to work for both situations—inheritance 


and implementation. In other words, that works for both extends and and works for BOT H classes 
implements. : 
and interfaces. 


And the winning word was...extends. But it really means “IS-A and 
works regardless of whether the type on the right is an interface or a 
class. 
Comparable is an interfate, so this 
REALLY reads, “T must be a type that 
implements the Comparable intertate. 


d 


public static <T extends Comparable<? super T>> void sort (List<T> list) 


It doesn’t matter whether the thing on the right is 
a Class or interface...you still say “extends.” 
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Dumb Questions 


Q: Why didn’t they just make a new keyword, “is”? 


A: Adding a new keyword to the language is a REALLY big deal because 
it risks breaking Java code you wrote in an earlier version. Think about it— 
you might be using a variable “is” (which we do use in this book to represent 
input streams). And since you're not allowed to use keywords as identifiers 
in your code, that means any earlier code that used the keyword before it 
was a reserved word, would break. So whenever there’s a chance for the 
language engineers to reuse an existing keyword, as they did here with 
“extends,” they'll usually choose that. But sometimes they don’t have a 
choice. 


In recent years, new “keyword-like” terms have been added to the language, 
without actually making it a keyword that would trample all over your earlier 
code. For example, the identifier var, which we'll talk about in Appendix B, 
is a reserved type name, not a keyword. This means any existing code that 
used var (for example, as a variable name) will not break if it’s compiled with 
a version of Java that supports var. 
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Finally we know whats wrong... 
The Song class needs to implement Comparable 


We can pass the ArrayList<Song> to the sort() method only if the Song 
class implements Comparable, since that’s the way the sort() method 
was declared. A quick check of the API docs shows the Comparable 
interface is really simple, with only one method to implement: 


The big question is: what 
makes one song less than, 
equal to, or greater than 
another song? 


You can’t implement the 
Comparable interface until you 
make that decision. 


java.lang.Comparable 


public interface Comparable<T> { 
int compareTo(T o); 


} 


Ge sharpen your pencil 
agerpen your p 


Write in your idea and pseudocode (or 
better, REAL code) for implementing the 
compareTo() method in a way that will 
sort() the Song objects by title. 


And the method documentation for compare Tol) says: 


Returns: 

a negative integer if this object is 
less than the specified object; 

a zero if they're equal; 

a positive integer if this object is 
greater than the specified object. 


Hint: if you're on the right track, it should 
take less than three lines of code! 


It looks like the compare To() method will be called on one Song 
object, passing that Song a reference to a different Song, The Song 
running the compareTo() method has to figure out if the Song it 
was passed should be sorted higher, lower, or the same in the list. 


Your big job now is to decide what makes one song greater 

than another, and then implement the compare To() method to 
reflect that. A negative number (any negative number) means 

the Song you were passed is greater than the Song running the 
method. Returning a positive number says that the Song running 
the method is greater than the Song passed to the compareTo() 
method. Returning zero means the Songs are equal (at least for 
the purpose of sorting...1t doesn’t necessarily mean they’re the 
same object). You might, for example, have two Songs by different 
artists with the same title. 


(That brings up a whole different can of worms we'll look at 


later...) ——> Yours to solve. 
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the Comparable interface 


The new, improved, comparable Song class 


We decided we want to sort by title, so we implement the compare To() 
method to compare the title of the Song passed to the method against the 
title of the song on which the compareTo() method was invoked. In other 
words, the song running the method has to decide how its title compares to 
the title of the method parameter. 


Hmmm...we know that the String class must know about alphabetical order, 

because the sort() method worked on a list of Strings. We know String has 

a compare [o() method, so why not just call it? That way, we can simply let 

one title String compare itself to another, and we don’t have to write the 

comparing/alphabetizing algorithm! Usually these match...we're speci fying the type that 
the implementing tlass can be compared against. 


This means that SongV3 a tan be compared to 
a A other SongV/3 objects, for the purpose of sorting, 
class SongV3 implements Comparable<Songv3> { 

private String title; 


private String artist; The sort) method sends a Sono, to compare Tol) 
private int bpm; —_ to see how that Sono, Compares to the Sono, on 
which the method was invoked. 
public int compareTo(SongV3 s) { S ie! 
return title.compareTo(s.getTitle()); Imple! We just 
ee just pass £h 
. . . . . € we know Strings h ects, 
SongV3 (String title, String artist, int bpm) { Compare To() method ave a 


this.title = title; 
this.artist = artist; 
this.bpm = bpm; 

} 


public String getTitle() { 
return title; 


This time it worked. lt prints the list and then calls 


3 ` itle. 
public String getArtist() { sort, whith puts the Songs in alphabetical order by titl 
return artist; 
} 


$java Jukebox3 


ublic int getBpm() { A : 
p A Mo n [somersault, cassidy, $10, havana, Cassidy, 50 


} ways] 


[$10, 50 ways, Cassidy, cassidy, havana, somer- 
sault] 


public String toString() { 
return title; 


} 
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We can sort the list, but... 


There’s a new problem—Lou wants two different views of the song list, one 
by song title and one by artist! 


But when you make a collection element comparable (by having it 


implement Comparable), you get only one chance to implement the 
compare To() method. So what can you do? 


The horrible way would be to use a flag variable in the Song class and 
then do an # test in compareTo() and give a different result depending on 
whether the flag is set to use title or artist for the comparison. 


But that’s an awful and brittle solution, and there’s something much better. 
Something built into the API for just this purpose—when you want to sort 
the same thing in more than one way. 


Look at API documentation again. There’s a second 
sort() method on Collections—and it takes a 


Comparator. There’s also a sort method on List that 
takes a Comparator. 


Excerpts from the API 


util.Collections . 
MLN Sorts the specified list into ascending order, accord 


sort(List Comparator): Sorts the specified list according to the 


sava.util.List l 
Jort(Comparator) Sorts this list according 


ake iy overloaded 


ing to the natural ordering of its elements. 


order induced by the specified Comparator. 


to the order induced by the specified Comparator. 


collections with generics 


That's not good enough. 
Sometimes I want it to sort 
by artist instead of title. 


2 ve ovt how to 
è Comparato. ing Called tates a yee ie = ge inte 
di a Compar | ‘A 
“ the songs by artist instead 
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Using a custom Comparator 


A Comparable element in a list can compare ttself 

to another of its own type in only one way, using its 
compareTo() method. But a Comparator is external to the 
element type you’re comparing—it’s a separate class. So you 
can make as many of these as you like! Want to compare 
songs by artist? Make an ArtistComparator. Sort by beats 
per minute? Make a BpmComparator. 


Then all you need to do is call a sort() method that takes a 
Comparator (Collections.sort or List.sort), which will use this 
Comparator to put things in order. 


The sort() method that takes a Comparator will use the 
Comparator instead of the element’s own compare To() 
method when it puts the elements in order. In other words, if 
your sort() method gets a Comparator, it won’t even call the 
compareTo() method of the elements in the list. The sort() 
method will instead invoke the compare() method on the 
Comparator. 


To summarize, the rules are: 


J> Invoking the Collections.sort(List list) method 
means the list element’s compareTo() method 
determines the order. The elements in the list MUST 
implement the Comparable interface. 


J> Invoking List.sort(Comparator c) or 
Collections.sort(List list, Comparator c) means 
the Comparator's compare() method will be 
used. That means the elements in the list do NOT 
need to implement the Comparable interface, 
but if they do, the list element's compareTo() 
method will NOT be called. 


java.util.Comparator 


public interface Comparator<T> { 
int compare(T ol, T 02); 


} 


If you pass a Comparator to the 
sort() method, the sort order is 
determined by the Comparator. 


If you don’t pass a Comparator 
and the element is Comparable, the 
sort order is determined by the 
element’s compare Tol) method. 
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Dumb Questions 


Q: 


Why are there two sort methods that take a comparator on two 


different classes? Which sort method should I use? 


A: Both methods that take a comparator, Collections.sort(List, Compara- 
tor) and List.sort(Comparator), do the same thing; you can use either and 
expect exactly the same results. 


List.sort was introduced in Java 8, so older code must use Collections. 
sort(List, Comparator). 


We use List.sort because it’s a bit shorter, and generally you already have the 
list you want to sort, so it makes sense to call the sort method on that list. 
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Updating the Jukebox to use a Comparator 


We're going to update the Jukebox code in three ways: 


1. Create a separate class that implements Comparator (and thus the compare() 
method that does the work previously done by compareTo/()). 


2. Make an instance of the Comparator class. 


3. Call the List.sort() method, giving it the instance of the Comparator class. 


import java.util.*; 


public class Jukebox4 { 
public static void main(String[] args) { 
new Jukebox4().go(); 
} 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3(); 


System.out.println(songList) ; Make an instance af the 


Ss. 
Collections.sort(songList) ; Comparator cla 


System.out.printin(songList) ; 


ArtistCompare artistCompare = new ArtistCompare() ; Invoke sort() on our list, Passing 


songList.sort (artistCompare) ; a it a reference to the new custo 
Comparator object. 7 


System.out.printin(songList) ; 
} 


class ArtistCompare implements Comparator<Songv3> { ) 
public int compare (SongV3 one, SongV3 two) { We've letting the Strin 
return one.getArtist () .compareTo(two.getArtist ()); variables (Lor artist) do 
} SS = the actual Comparison, 


} This is a String (the artist) ae Strings already 
now how alphabetize 
hemselves. 
List 
yn" 
%java Jukebox4 Unsorted S 
[somersault, cassidy, $10, havana, Cassidy, 50 ways] a th 
P F Led V title em < 
[$10, 50 ways, Cassidy, cassidy, havana, somersault] Sorted PY To me hod) 
Song s Compare om 
[havana, Cassidy, cassidy, $10, 50 ways, somersault] 
Sor 
d b 
lusi a 
“sing Arteen St name 
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exercise: sharpen your pencil 


ote your pencil Fill-in-the-blanks 


For each of the questions below, fill in the blank 
with one of the words from the “possible answers” 
list, to correctly answer the question. 


Possible Answers: 
Comparator, 
Comparable, 
compareTo( ), 
compare( ), 

yes, 
no 


Given the following compilable statement: 


Collections.sort (myArrayList) ; 


1. What must the class of the objects stored in myArrayList implement? 


2. What method must the class of the objects stored in myArrayList implement? 


3. Can the class of the objects stored in myArrayList implement both 
Comparator AND Comparable? 


Given the following compilable statements (they both do the same thing): 


Collections.sort (myArrayList, myCompare) ; 
myArrayList.sort (myCompare) ; 


4. Can the class of the objects stored in myArrayList implement Comparable? 


5. Can the class of the objects stored in myArrayList implement Comparator? 


6. Must the class of the objects stored in myArrayList implement Comparable? 


7. Must the class of the objects stored in myArrayList implement Comparator? 


8. What must the class of the myCompare object implement? 


9. What method must the class of the myCompare object implement? 


————> Answers on page 364. 
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But wait! We're sorting in two different ways! 


Now we’re able to sort the song list two ways: 


1. Using Collections.sort(songList), because Song implements Comparable 
2. Using songLists.sort(artistCompare) because the ArtistCompare class implements Comparator 


While our new code allows us to sort songs by title and by artist, it is reminiscent of Frankenstein’s monster, 
cobbled together bit by bit. 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3 () ; 
System.out.printin(songList) ; This uses Comparable to sort 


Collections.sort (songList) ; 
System.out.printin(songList) ; 


ArtistCompare artistCompare = new ArtistCompare(); 


songList.sort (artistCompare) ; . 
Pe This uses a Custom 


System.out.printin(songList) ; 
Comparator to sort 


A better approach would be to handle 
all of the sorting definitions in classes 
that implement Comparator. 


there, are_no 


Dumb Questions 


Q: So does this mean that if you have a class that Q: But why doesn’t every class implement Comparable? 
doesn’t implement Comparable, and you don’t have the 

source code, you could still put the things in order by A 
creating a Comparator? 


- Do you really believe that everything can be ordered? 
If you have element types that just don’t lend themselves to 
A: any kind of natural ordering, then you'd be misleading other 
* That’s right. The other option (if it’s possible) would be programmers if you implement Comparable. And there's no 
to subclass the element and make the subclass implement problem if you don’t implement Comparable, since a programmer 
Comparable. can compare anything in any way that they choose using their 
own custom Comparator. 
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Sorting using only Comparators 


Having Song implement Comparable and creating a custom Comparator for sorting by Artist absolutely works, 
but it’s confusing to rely on two different mechanisms for our sort. It’s much clearer if our code uses the same 
technique to sort, regardless of how Lou wants his songs sorted. The code below has been updated to use 
Comparators for sorting by both Title and Artist; the new code is in bold. 


public class Jukebox5 { 
public static void main(String[] args) { 
new Jukebox5().go(); 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3(); 
System.out.printin(songList) ; 
Make an instance of the 
TitleCompare titleCompare = new TitleCompare() ; Comparator class and use the 
songList.sort (titleCompare) ; sort method on List. 
System.out.printin(songList) ; 


ArtistCompare artistCompare = new ArtistCompare(); 
songList.sort (artistCompare) ; ; 
System.out.printlin(songList) ; This is the new class that 
} implements Comparator. 
} 
class TitleCompare implements Comparator<SongV3> { 
public int compare (SongV3 one, SongV3 two) { 
return one.getTitle() .compareTo (two.getTitle()); 


} 
class ArtistCompare implements Comparator<SongV3> { 
public int compare (SongV3 one, SongV3 two) { 
return one.getArtist () .compareTo(two.getArtist()); 


// more specialized Comparator classes could go here, O 


// e.g. BpmCompare 
D 


That's an awful lot of 
code for sorting our songs 
in just two different orders. 
Isn't there a better way? 
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Just the code that matters 


The Jukebox class does have a lot of code that’s needed for sorting. Let’s zoom in on one 
of the Comparator classes we wrote for Lou. The first thing to notice is that all we really 
want to sort our collection is the one line of code in the middle of the class. The rest of 
the code is just the long-winded syntax that’s necessary to let the compiler know what 
type of class this is and which method it implements. 


Code Up Clase 


The one line of tode that’s 
doing all the work 


class TitleCompare implements Comparator<Song> { 
public int compare(Song one, Song two) { 
return one.getTitle() .compareTo(two.getTitle()); 


There’s more than one way to declare small pieces of functionality like this. One 
approach is inner classes, which we’ll look at in a later chapter. You can even 
declare the inner class right where you use it (instead of at the end of your class 
file); this is sometimes called an “argument-defined anonymous inner class.” Sounds 
fun already: 


songList.sort (new Comparator<SongV3>() { L47 Relax 


public int compare (SongV3 one, SongV3 two) { We're not 


return one.getTitle() .compareTo(two.getTitle()); going to learn 
} how to write 


1); “argument-defined anony- 
r . 
mous inner classes”! 


We just wanted you to 
see this example, in case 
you stumble across it in Real Code. 


While this lets us declare the sorting logic in exactly the location we 
need it (where we call the sort method, instead of in a separate class), 
there’s still a lot of code there for saying “sort by title please”). 
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the compiler already knows 


What do we REALLY need in order to sort? 


public class Jukebox5 { The Compiler Knows — 
public void go() { tontains Songy? objet . 
List<SongV3> songList = MockSongs.getSongsV3 (); 


TitleCompare titleCompare = new TitleCompare(); 
songList.sort (titleCompare) ; Th 
e Compiler und 
E Po Ta: that 
(A 

} Songy3 et iia Comparator for 
} 
class TitleCompare implements Comparator<SongV3> { 

public int compare (SongV3 one, SongV3 two) { 

return one.getTitle() .compareTo(two.getTitle()); 

} 

} 


Let’s take a look at the API documentation for the sort method on List: 


default void sort(Comparator<? super E> c) Sorts this list according to the order 
induced by the specified Comparator. 


If we were to explain out loud the following line of code: 


songList.sort (titleCompare) ; 


We could say: 


“Call the sort method on the list of songs (1) and pass ita 
reference to a Comparator object, which is designed specifically 
to sort Song objects @.” 

If we’re honest, we could say all that without even looking at the ‘TitleCompare class. 


We can work it all out just by looking at the documentation for sort and the type of the 
List that we’re sorting! 


<P) 


Do you think the compiler cares about the name 
“TitleCompare’”? If the class was called “FooBar” 
instead, would the code still work? 


© 


338 chapter 11 


collections with generics 


Wouldn't it be wonderful 

if the code that described HOW 
you want to sort your Songs 
wasn't so far away from the 

sort method? And wouldn't it be 
great if you didn't have to write a 
bunch of code the compiler could 
probably figure out on its own... 
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lambda expressions 


Enter lambdas! Leveraging what the compiler can infer 


We could write a whole bunch of code to say how to sort a list (like 


we have been doing)... This is just a reference to an object that 


implements Cor k 
ee matter to tke ype i Its name doesn’t 


songList.sort (titleCompare) ; 


The Compiler cares Doh! The Compi 


t i ler ĉan i ; 
al Beene pe e sort) does. n nfer this from 


class TitleCompare implements Comparator<Song> { The Compiler ean fi 


ure 
=. =; out that the two a, ets 
Yup, the nie. Me a ae have to be Son aberi: 


knows what his public int compare (Song one, Song two) { J songlist isa List of 
method should ong objects. 
look like. return one.getTitle() .compareTo(two.getTitle() ); 


j ! a ei T 


Se This is ALL THE COMPILER NEEDS. 


Just tell it HOW to do the sort! 


Or, we could use a lambda... oe 


songList.sort((one, two) -> one.getTitle() .compareTo (two.getTitle())); 


i» 


Brain Barbell 


What do you think would happen if Comparator 


needed you to implement more than one method? 


How much could the compiler fill in for you? 
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Where did all that code go? 


To answer this question, let’s take a look at the API documentation 
for the Comparator interface. 


Method Summary 
Modifier and Type Method Description 
int compare(T ol, T 02) Compares its two arguments for order. 
boolean equals(Object obj) Indicates whether some other object is 


"equal to" this comparator. 


Because equals has been implemented by Object, if we create a 
custom comparator, we know we only need to implement the compare 
method. 


We also know exactly the shape of that method—1it has to return an inherits m h equals is 
int, and it takes two arguments of type T (remember generics?). Our Objet an d in elass Objett 
lambda expression implements the compare() method, without having implemente 

to declare the class or the method, only the details of what goes into 

the body of the compare() method. 


Some interfaces have only ONE 
method to implement 


With interfaces like Comparator, we only have to implement a single 
abstract method, SAM for short. These interfaces are so important that 
they have several special names: 


SAM Interfaces axk.a. Functional Interfaces 


If an interface has only one method that needs to be implemented, that 
interface can be implemented as a lambda expression. You don’t need 
to create a whole class to implement the interface; 

the compiler knows what the class and method 


would look like. What the compiler doesnt know t 
is the logic that goes inside that method. | e ax 


We'll look at lambda expressions 
and functional interfaces in much 
more detail in the next chapter. For now, 


back to Lou’s diner. 
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sorting with lambdas 


Updating the Jukebox code with lambdas 


import java.util.*; 


public class Jukebox6é { 
public static void main(String[] args) { 
new Jukebox6() .go(); 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3(); 
System.out.printin(songList) ; . tion—no need to 
1 oue lambda expression ' wet 
eres Ou 
yak a custom Compa 4 method eall. 


m L se 
sorting loge voht inside $ 
songList.sort ( (one, two) -> one.getTitle ().compareTo (two.getTitle{))); 
a rit1e 


System.out.println(songList); Pa , 


You can tell what the list will be sorted by, just 
by looking, at the Field used in the lambda. 
wot = 
songList.sort((one, two) -> one.getArtist () .compareTo (two.getArtist ())); 
System.out.printin(songList) ; 


} File Edit Window Help Ambient 


% java Jukebox6 


Tre output is exactly t na [somersault, cassidy, $10, havana, Cassidy, 50 ways] 
arator ? 
when we used PAAT shorter: 


i [$10, 50 ways, Cassidy, cassidy, havana, somersault] 
but our Code w 


[havana, Cassidy, cassidy, $10, 50 ways, somersault] 


etapon you perel How could you sort the songs differently? 


Write lambda expressions to sort the songs in these ways (the 
answers are at the end of the chapter): 


= Sort by BPM | 
= Sort by title in descending order ois on 
page 366. 
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etep yr paul Reverse Engineer 


Assume this code exists in a single file. Your job is 
to fill in the blanks so the program will create the 


output shown. 


import 


public class SortMountains { 


public static void main(String [] args) { 


new SortMountains().go(); 


public void go() { 


List mountains 


new ArrayList<>() ; 


mountains .add (new Mountain("Longs", 14255)); 
mountains .add(new Mountain ("Elbert", 14433)); 
mountains .add(new Mountain ("Maroon", 14156)); 
mountains .add (new Mountain ("Castle", 14265)); 
System.out.printin ("as entered:\n" + mountains); 


mountains. — —  ( -> 


); 


System.out.printin ("by name:\n" + mountains); 


( -> 


); 


System.out.printin ("by height:\n" + mountains); 


class Mountain { 


———> Answers on page 365. 


Output: 


File Edit Window Help ThisOne’sForBob 
Sjava SortMountains 


as entered: 
[Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 


by name: 


[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 
by height: 
[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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dealing with duplicates 


Uh-oh. The sorting all works, but now we have duplicates... 


The sorting works great; now we know how to sort on both ééle and artist. But there’s a new problem 
we didn’t notice with a test sample of the jukebox songs—the sorted list contains duplicates. 


Unlike the mock code, Lou’s real jukebox application appears to just keep writing to the file 
regardless of whether the same song has already been played (and thus written) to the text file. The 
SongListMore. txt jukebox text file is an example. It’s a complete record of every song that was played, 
and might contain the same song multiple times. 


%$ java Jukebox7 


[Somersault: zero 7, cassidy: grateful dead, $10: hitchhiker, Before sorting 
havana: cabello, $10: hitchhiker, cassidy: grateful dead, 50 
ways: simon] 


After sorting by 
[$10: hitchhiker, $10: hitchhiker, 50 ways: simon, cassidy: song title 
grateful dead, cassidy: grateful dead, havana: cabello, 
somersault: zero 7] 
[havana: cabello, cassidy: grateful dead, cassidy: grateful 
dead, $10: hitchhiker, $10: hitchhiker, 50 ways: simon, After sorting by 
somersault: zero 7] artist name 
Note tha 
Cong big iA the 
title and the artist Put the 
SongListMore. txt 
The Sonali 
«+e what the actual ~ > somersault, zero 7, 147 Song istMore text : 
This aa tke looks like. cassidy, grateful dead, 158 duplicates in it, because ile now has 
song $10, hitchhiker, 140 machine is writing every so a ebox 
havana, cabello, 105 in order. y ng played, 
$10, hitchhiker, 140 To oet 
cassidy, grateful dead, 158 a kaai om we wrote 
50 ways, simon, 102 ge ongs meld foe a 
ist that has all the we returned a 
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We need a Set instead of a List 


From the Collection API, we find three main interfaces, List, Set, and Map. 
ArrayList is a List, but it looks like Set is exactly what we need. 


Duplicates OK. 


> LIST - when sequence matters 
Collections that know about index position. 


Lists know where something is in the list. You 
can have more than one element referencing 


the same object. 

> SET -when uniqueness matters NO duplicates. 
Collections that do not allow duplicates. | ean = 
Sets know whether something is already in the collection. a 
You can never have more than one element referencing 
the same object (or more than one element referencing 
two objects that are considered equal—we'll look at what Set 


object equality means in a moment). 


> MAP -when finding something by key matters 
Collections that use key-value pairs. 
Maps know the value associated with a given key. You 


can have two keys that reference the same value, but you 
cannot have duplicate keys. A key can be any object. 
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the collections API 


The Collection API (part of it) 


Notice that the Map interface doesn’t actually 
extend the Collection interface, but Map 

is still considered part of the “Collection 
Framework” (also known as the “Collection 


API”). So Maps are still collections, even i 
though they don’t include java.util.Collection Collector 
ace i ee (interface) 


in their inheritance tree 


(Note: this is not the complete 


collection API; there are other 


classes and interfaces, but 
these are the ones we care 
most about.) 


Set List 
(interface) (interface) 
a T ~ Ly 


oh 
I 
I ` 
I \ 
A ` 
SortedSet i \ 3 y ` 
- ` 
(interface) l ` 7 \ 
i 
Í 
I 
I 
I 


\ a 
I 
` 
` I 
Li ` s 
` 
a 
\ 
1 I 
I 


TreeSet | timo HashSet | ArrayList LinkedList Vector 


KEY 
T extends Mars don t extend from 
T : javaw util.Colleetion, but 
: implements they're still considered 
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~ S, still referred to as a 
i N, collection. 


Map to be part of the 
j Collection Framework 
_anieraco | in Java. So a Map is 


SortedMap \ s 


(interface) 


TreeMap f HashMap enol Hashtable 
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Using a HashSet instead of ArrayList 


We updated the Jukebox code to put the songs in a HashSet to try to eliminate our duplicate 
songs. (Note: we left out some of the Jukebox code, but you can copy it from earlier versions.) 


import java.util.*; 


public class Jukebox8 { ka cekun a 
public static void main(String[] args) { Conds class ` same 
More>>? Kain the 
new Jukebox8 ().go(); T eveated a Me ae that ton 
e 
| of Sond hore tot 


List S 
\ = on) 
public void go() { values 3S 


List<SongV3> songList = MockMoreSongs.getSongsV3(); 
System.out.printlin(songList) ; 


songList.sort((one, two) -> one.getTitle().compareTo(two.getTitle())); 
System.out.printin(songList) ; 


Set<SongV3> songSet = new HashSet<>(songList) ; 
System. out .printi1n (songSet) ; 


l CF Hashset has a Constructor that takes a 
l i Collection, and it will create a set with all th 
We want the Set to hold SongV items from that collection. ° 


obiects. HashSet IS—A Set, so we can 
store the HashSet in this Set variable. 


File Edit Window Help GetBetterMusic 


%java Jukebox8 Before sorting 
the List. 
[somersault, cassidy, $10, havana, $10, cassidy, 50 ways] 
After sorting the 
[$10, $10, 50 ways, cassidy, cassidy, havana, somersault] List (by title). 


[$10, 50 ways, havana, cassidy, $10, cassidy, somersault] 


After putting it 
into a HashSet 


inting the 
it lost its sort order and printing ise 
The Set didn’t help ! ! Ne 2 put the list into a palee i a 
HashSet, but we ll worry about tall sort) ag 
We still have all the duplicates! that one later.) 
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object equality 


What makes Two objects equal? If two objects foo and bar are 


equal, foo.equals(bar) and 
bar.equals(foo) must be true, 
and both foo and bar must re- 


derd Lisisimpol efer I bj turn the same value from 
considered equal. is ıt simply two references to the very same object, hashCode(). For a Set to treat 


or is it two separate objects that both have the same tile? 


To figure out why using a Set didn’t remove the duplicates, we have 
to ask—what makes two Song references duplicates? They must be 


two objects as duplicates, you 


must override the hashCode() 
and equals() methods inherited 


from class Object so that you 


> Reference equality can make two different objects 
Two references, one object on the heap. be viewed as equal. 


This brings up a key issue: reference equality vs. object equality. 


Two references that refer to the same object on the heap are equal. 
Period. If you call the hashCode() method on both references, you'll 
get the same result. If you don’t override the hashCode () method, 
the default behavior (remember, you inherited this from class Object) 
is that each object will get a unique number (most versions of Java 
assign a hashcode based on the object's memory address on the 
heap, so no two objects will have the same hashcode). 


hashCode: 254 


If you want to know if two references are really referring to the same 
object, use the == operator, which (remember) compares the bits in 

the variables. If both references point to the same object, the bits will 
be identical. 


Song 
if (songl == song2) { 


// both references are referring 
// to the same object on the heap 


> Object equality 


Two references, two objects on the heap, but the 
objects are considered meaningfully equivalent. 


If you want to treat two different Song objects as equal (for 
example if you decided that two Songs are the same if they have 
matching title variables), you must override both the hashCode() 
and equals() methods inherited from class Object. 


As we said above, if you don’t override hashCode(), the default 
behavior (from Object) is to give each object a unique hashcode 
value. So you must override hashCode() to be sure that two 
equivalent objects return the same hashcode. But you must also 


; . . . . we Son 
override equals() so that if you call it on either object, passing in 9 
the other object, always returns true. 
if (songl.equals(song2) && songl.hashCode() == song2.hashCode()) { 


// both references are referring to either a 


// a single object, or to two objects that are equal 
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How a HashSet checks for duplicates: hashCode() and equals() 


When you put an object into a HashSet, it calls the 
object’s hashCode method to determine where to put 
the object in the Set. But it also compares the object’s 
hash code to the hash code of all the other objects in 
the HashSet, and if there’s no matching hash code, the 
HashSet assumes that this new object is not a duplicate. 


In other words, if the hash codes are different, the 
HashSet assumes there’s no way the objects can be equal! 


So you must override hashCode() to make sure the objects 
have the same value. 


But two objects with the same hash code might not be 
equal (more on this on the next page), so if the HashSet 


I need to know 
if your hashCode() 
values are the same. 


finds a matching hash code for two objects—one you’re 
inserting and one already in the set—the HashSet will 
then call one of the object’s equals() methods to see if 
these hash code—matched objects really are equal. 


And if they’re equal, the HashSet knows that the object 
you're attempting to add is a duplicate of something in the 
Set, so the add doesn’t happen. 


You don’t get an exception, but the HashSet’s add() 
method returns a boolean to tell you (if you care) whether 
the new object was added. So if the add() method 

returns false, you know the new object was a duplicate of 
something already in the set. 


Object you're trying to 
Ñ aad to the hahet 


Object already IN 
the HashSet. 
ee 


Your hash codes 
are the same, but are 
you REALLY equal? 


Object you're trying to add 
runs its equals() method, 
itle: Circles comparing, itself to song, 
hashCode: 742 Ñ and returns true. 


Object already IN 
the HashSet. 
ee 
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overriding hashCode() and equals() 


The Song class with overridden 
hashCode() and equals() 


this 


class SongV4 implements Comparable<Songv4> { Mi 
private String title; 4 Cor anyone else ealind 
: ae The HashSet `o other Song; 
private String artist; kh 4) sends it an 
private int bpm; metho f 
SEP: String 
: that title ìs a 
public boolean equals (Object aSong) { The GREAT aie i overridden equa s 
SongV4 other = (SongV4) aSong; and Strings hane hoe to do is ask one 
return title.equals(other.getTitle()) ; a method a ar “ho the other song s title. 
} title it its equ 
Same deal f 
ETE E E E E APO, idle lg Strin 
return title. hashCode () ; £< ti 


} 


9 elass has an overyi 
ethod, so you ean erridden 


calling hashCode() on the te Ney return the result of 


tice h 
equalst) are using the SAME P ta tier = 


public int compareTo(SongV4 s) { 
return title.compareTo(s.getTitle()); 


} 


SongV4 (String title, String artist, int bpm) { 
this.title = title; 
this.artist = artist; 
this.bpm = bpm; 


Now it works! No duplicates when we 
print out the HashSet. But we didn’t 
niie Geis eE call sort() again, and when we put 
HRE P the ArrayList into the HashSet, the 
; HashSet didn’t preserve the sort order. 


public String getArtist() { 
return artist; 
} %java Jukebox9 


File Edit Window Help Hashing!tOut 


public int getBpm() { [somersault, cassidy, $10, havana, $10, 
return bpm; Fi 

} cassidy, 50 ways] 

public String toString() { [$10, $10, 50 ways, cassidy, cassidy, havana, 


return title; somersault] 
} 


[havana, $10, 50 ways, cassidy, somersault] 
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Java Object Law for hashCode() 
and equals() 


The API docs for class Object state the 
rules you MUST follow: 


> If two objects are equal, they MUST 
have matching hash codes. 


> If two objects are equal, calling equals() 
on either object MUST return true. In other 
words, if (a.equals(b)) then (b.equals(a)). 


> If two objects have the same hash code 
value, they are NOT required to be equal. 
But if they’re equal, they MUST have the 
same hash code value. 


> So, if you override equals(), you MUST 
override hashCode(). 


> The default behavior of hashCode() 

is to generate a unique integer for each 
object on the heap. So if you don’t override 
hashCode() in a class, no two objects of 
that type can EVER be considered equal. 


> The default behavior of equals() is to 
do an == comparison. In other words, to 
test whether the two references refer toa 
single object on the heap. So if you don’t 
override equals() in a class, no two objects 
can EVER be considered equal since 
references to two different objects will 
always contain a different bit pattern. 


a.equals(b) must also mean that 
a. hashCode() == b.hashCode() 


But a.hashCode/() == b.hashCode() 
does NOT have to mean a.equals(b) 


collections with generics 


there, are_no 


Dumb Questions 


-+ How come hash codes can be the same 
even if objects aren’t equal? 


A: HashSets use hash codes to store the 
elements in a way that makes it much faster to 
access. If you try to find an object in an ArrayList 
by giving the ArrayList a copy of the object (as 
opposed to an index value), the ArrayList has to 
start searching from the beginning, looking at 
each element in the list to see if it matches. But 

a HashSet can find an object much more quickly, 
because it uses the hash code as a kind of label on 
the “bucket” where it stored the element. So if you 
say, “| want you to find an object in the set that’s 
exactly like this one...) the HashSet gets the hash 
code value from the copy of the Song you give it 
(say, 742), and then the HashSet says, “Oh, | know 
exactly where the object with hash code #742 is 
stored...” and it goes right to the #742 bucket. 


This isn’t the whole story you get in a computer 
science class, but it’s enough for you to use 
HashSets effectively. In reality, developing a good 
hashing algorithm is the subject of many a PhD 
thesis, and more than we want to cover in this 
book. 


The point is that hash codes can be the same 
without necessarily guaranteeing that the objects 
are equal, because the “hashing algorithm” used 
in the hashCode() method might happen to return 
the same value for multiple objects. And yes, that 
means that multiple objects would all land in the 
same hash code bucket in the HashSet, but that’s 
not the end of the world. The HashSet might be 

a little less efficient, because if the HashSet finds 
more than one object in the same hash code 
bucket, it has to use the equals() on all those 
objects to see if there's a perfect match. 
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TreeSets and sorting 


If we want the set to stay sorted, 
weve got TreeSet 


TreeSet is similar to HashSet in that it prevents duplicates. But it also keeps the list sorted. It works just like 
the sort() method in that if you make a TreeSet without giving it a Comparator, the TreeSet uses each 
object’s compareTo() method for the sort. But you have the option of passing a Comparator to the TreeSet 
constructor, to have the TreeSet use that instead. 


The downside to TreeSet is that if you don’t need sorting, you’re still paying for it with a small performance 
hit. But you’ll probably find that the hit is almost impossible to notice for most apps. 


public class Jukebox10 { 
public static void main(String[] args) { 
new Jukebox10().go(); 
} 


public void go() { 
List<SongV4> songList = MockMoreSongs.getSongsV4 () ; 
System.out.printin(songList) ; 


songList.sort((one, two) -> one.getTitle() .compareTo(two.getTitle())); 
System.out.printin(songList) ; 


Set<SongV4> songSet = new TreeSet<>(songList) ; Cet The 
System.out.printin(songSet) ; T eeSet m ead of HashSe i 
Create a 'v se Sona 4's Compare To 
7 : 


£ the items in songlist- 


If we want the TreeSet to sort on something different (i.e., to NOT use SongV4’s 
compareTo() method), we need to pass in a Comparator (or a lambda) to the TreeSet 
constructor. Then we’d use songSet.addAll() to add the songList values into the TreeSet. 


Set<SongV4> songSet = new TreeSet<>((ol, 02) -> ol.getBpm() - 0o2.getBpm()); 
songSet .addA1l1(songList) ; 
Yer, another lambda for 
sorting, This one Sov 
by BPM. Remember, 
this lambda implemen 
Comparator: 


352 chapter 11 


collections with generics 


What you MUST know about TreeSet... 


TreeSet looks easy, but make sure you really understand what you need to do to 


use it. We thought it was so important that we made it an exercise so you’d have to 


think about it. Do NOT turn the page until you’ve done this. We mean it. 


harpen your pencil 
emer yf 


Look at this code. 
Read it carefully, then 
answer the questions 
below. (Note: there 
are no syntax errors in 
this code.) 


———— Answers on page 366. 


import java.util.*; 


public class TestTree { 
public static void main(String[] args) { 
new TestTree() .go(); 


public void go() { 
Book b1 = new Book("How Cats Work"); 
Book b2 = new Book("Remix your Body") ; 
Book b3 new Book ("Finding Emo"); 


Set<Book> tree = new TreeSet<>() ; 
tree.add(b1) ; 

tree.add(b2) ; 

tree.add(b3) ; 
System. out .printin (tree); 


class Book { 
private String title; 
public Book(String t) { 
title = t; 


1. What is the result when you compile this code? 


2. If it compiles, what is the result when you run the TestTree class? 


3. If there is a problem (either compile-time or runtime) with this code, how would you fix it? 


you are here > 
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how TreeSets sort 


TreeSet elements MUST be comparable 


TreeSet can’t read the programmer’s mind to figure out how the objects 
should be sorted. You have to tell the TreeSet how. 


To use a TreeSet, one of these things 
must be true: 


> The elements in the list 
must be of a type that 
implements Comparable 


The Book class on the previous page didn’t class Book implements Comparable<Book> { 
implement Comparable, so it wouldn't work private String title; 

at runtime. Think about it, the poor TreeSet’s public Book(String t) { 

sole purpose in life is to keep your elements title = t; 

sorted, and once again—it had no idea how to } 


sort Book objects! It doesn’t fail at compile-time, 
because the TreeSet add() method doesn't 
take a Comparable type. The TreeSet add() 
method takes whatever type you used when } 
you created the TreeSet. In other words, if 

you say new TreeSet<Book>(), the add() 
method is essentially add(Book). And there’s 

no requirement that the Book class implement 
Comparable! But it fails at runtime when you 
add the second element to the set. That’s the 
first time the set tries to call one of the object's 
compareTo() methods and...can't. 


public int compareTo(Book other) { 
return title.compareTo (other.title) ; 


} 


oO R class BookCompare implements Comparator<Book> { 
public int compare (Book one, Book two) { 
> You use the TreeSet’s return one.title.compareTo(two.title) ; 


overloaded constructor } You could use a lambda 


; eclaring a 
that takes a Comparator k instead of d ace 
public class TestTreeComparator { yew Compara ` 


public void go() { 
Book bl = new Book ("How Cats Work"); 
Book b2 = new Book ("Remix your Body"); 


TreeSet works a lot like the sort() 
method—you have a choice of using the 


element's compareTo() method, assuming Book b3 = new Book ("Finding Emo"); 

the element type implemented the BookCompare bookCompare = new BookCompare(); 
Comparable interface, OR you can use Set<Book> tree = new TreeSet<>(bookCompare) ; 
a custom Comparator that knows how tree.add (b1); 

to sort the elements in the set. To use a tree.add (b2); 

custom Comparator, you call the TreeSet tree.add (b3); 


constructor that takes a Comparator. Sremo OUt, PRINETANEPES)} 
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We've seen Lists and Sets, now we'll use a Map 


Lists and Sets are great, but sometimes a Map 1s the best collection (not Collection with a 
capital “C”—remember that Maps are part of Java collections but they don’t implement the 
Collection interface). 


Imagine you want a collection that acts like a property list, where you give it a name and it 
gives you back the value associated with that name. Keys can be any Java object (or, through 
autoboxing, a primitive), but you'll often see String keys (i.e., property names) or Integer keys 
(representing unique IDs, for example). 


| 
i Each element in a Map is actually 


TWO objects—a key and a value. 
key > “Ball4” You can have duplicate values, but 
NOT duplicate keys. 


Map example 


public class TestMap { 
public static void main(String[] args) { 
Map<String, Integer> scores = new HashMap<> () ; 


H (oaa 
ashMap needs TWO type parameters—one for the key and one for the value 


scores.put("Kathy", 42); 
P Yor , Use put() 


scores .put("Bert", 343); €—— instead of addQ), and now of Course 
scores.put("Skyler", 420); it takes two arguments (key, value). 


System.out.println (scores); 


System.out.println (scores.get ("Bert")); The getl) method Likec sk pe 
ey a 
the value (in this tase, an In Hae returns 


File Edit Window Help WhereAm| 


%$java TestMap When you print a elt it gives you the key= 
Pairs, in braces { } instes gue i backs = 
{Skyler=420, Bert=343, Kathy=42} You see when you print lists and se 


343 
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factory methods for collections 


Good point! Let me 
just whip up some 
Factory methods. 


I keep seeing the same code 

popping up again and again for 
creating collections. There must be 
something we can do to make this 
easier for people. 


Creating and filling 
collections 


The code for creating, and then filling, a collec- 
tion crops up again and again. You’ve already 
seen code for creating an ArrayList and adding 
elements to it quite a few times. Code like this: 


List<String> songs = new ArrayList<>(); 
songs .add ("somersault"); 

songs .add ("cassidy"); 

songs .add ("$10"); 


Whether you’re creating a List, a Set, or a Map, it looks pretty similar. What’s more, 
these types of collections are often ones where we know what the data is right at the 
start, and then we don’t intend to change it at all during the lifetime of the collection. 
If we wanted to really make sure that no-one changed the collection after we’d 


created it, we’d have to add an extra step: shee n oe i 
W ren 
List<String> songs = new ArrayList<>()j; Rewer a yt ont w 
songs .add ("somersault"); ok Ane \ é else van A \% 
songs.add("cassidy"); now no OW i "r 
songs.add("$10"); ny eee Cha! ore be 
return Collections.unmodifiableList (songs) ; we m myt San ak van 
bi sue pure 
da 


That’s a lot of code! And it’s a lot of code for something common pranaeo” 
that we probably want to do a lot. 


Fortunately for us, Java now has “Convenience Factory Methods of Collections” (they 
were added in Java 9). We can use these methods to create common data structures 
and fill them with data, with just one method call. 
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Convenience Factory Methods for Collections 


Convenience Factory Methods for Collections allow you to easily create a List, Set, or Map that’s been prefilled 
with known data. There are a couple of things to understand about using them: 


© The resulting collections cannot be changed. You can't add to them or 
alter the values; in fact, you can't even do the sorting that we've seen in this 
chapter. 


© The resulting collections are not the standard Collections we've seen. 
These are not ArrayList, HashSet, HashMap, etc. You can rely on them to 
behave according to their interface: a List will always preserve the order in 
which the elements were placed; a Set will never have duplicates. But you 
can't rely on them being a specific implementation of List, Set, or Map. 


Convenience Factory Methods are just that—a convenience that will work for most of the cases where you want 
to create a collection prefilled with data. And for those cases where these factory methods don’t suit you, you can 
still use the Collections constructors and add() or put() methods instead. 


» Creating a List: List. of () 
To create the list of Strings from the last page, we don’t need five lines of code; we just need one: 
List<String> strings = List.of("somersault", "cassidy", "$10"); 
If you want to add Song objects instead of simple Strings, it’s still short and descriptive: 


List<Songv4> songs = List.of (new SongV4("somersault", "zero 7", 147), 
new Songv4("cassidy", "grateful dead", 158), 
new Songv4("$10", "hitchhiker", 140)); 


> Creating a Set: Set . of () 


Creating a Set uses very similar syntax: 


Set<Book> books = Set.of (new Book ("How Cats Work"), 
new Book ("Remix your Body"), 
new Book ("Finding Emo") ) ; 


> Creating a Map: Map. of (), Map.ofEntries () 


Maps are different, because they take two objects for each “entry”—a key and a value. If you want to put less 
than 10 entries into your Map, you can use Map.of, passing in key, value, key, value, etc.: 


Map<String, Integer> scores = Map.of("Kathy", 42, 
"Bert", 343, 
"Skyler", 420); 


If you have more than 10 entries, or if you want to be clearer about how your keys are paired up to their values, 
you can use Map.ofEntries instead: 


Map<String, String> stores = Map.ofEntries(Map.entry("Riley", "Supersports"), 
Map.entry("Brooklyn", "Camera World"), 
Map.entry("Jay", "Homecase") ) ; 


To make the line shorter, you can use a static import on Map.entry (we talked about static imports in Chapter 10). 
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Finally, back to generics 


Remember earlier in the chapter we talked about how methods that 
take arguments with generic types can be...weird. And we mean weird 
in the polymorphic sense. If things start to feel strange here, just 
keep going—it takes a few pages to really tell the whole story. The 
examples are going to use a class hierarchy of Animals. 


abstract class Animal { 
void eat() { 
System.out.printin("animal eating"); 


} 

} The simplifj . 

diass Dog extends Animal 4 mplitied Animal elass hierarchy 
void bark() { } 


} 
class Cat extends Animal { 
void meow() { } 


} 


Using polymorphic arguments and generics 


Generics can be a little...counterintuitive when it comes to using 
polymorphism with a generic type (the class inside the angle brackets). Let’s 
create a method that takes a List<Animal> and use this to experiment. 


Passing in List<Animal> 


public class TestGenerics1 { met the List 
public static void main(String[] args) { od we just | factory 
oo 


List<Animal> animals = List.of(new Dog(), new Cat(), new Dog ()); 
takeAnimals (animals) ; Pass a List<Animal> into 


} our testAnimals method Method that es 3 
public static void takeAnimals (List<Animal> animals) { <— generit elass (Lis 
for (Animal a : animals) { a parameter 
a.eat(); 
erage we Can eall ONLY th Compiles and runs just fine 
methods declared in 4 fea 
: e 
since the animals parar Pena ak 


type List<Ani 
á finimal>. %java TestGenerics1 


animal eating 
animal eating 
animal eating 
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But will it work with List<Dog>? 


A List<Animal> argument can be passed to a method with a List<Animal> 
parameter. So the big question is, will the List<Animal> parameter accept a 
List<Dog>? Isn’t that what polymorphism is for? 


Passing in List<Dog> 


public void go() { 
List<Animal> animals = List.of(new Dog(), new Cat(), new Dog()); 


takeAnimal imals) ; 
akeAnimals (animals); g&— We know this line worked fine 


Make a Dog List and 


List<Dog> dogs = List.of(new Dog(), new Dog()); 
put a Couple dogs in. 


takeAnimals (dogs); <_ Will this work now that we chan 


} From an array to a List? wis 


public void takeAnimals (List<Animal> animals) { 
for (Animal a : animals) { 
a.eat(); 


} 


When we compile it: 


File Edit Window Help CatsAreSmarter 


% javac TestGenerics2. java 


TestGenerics2.java:20: error: incompatible types: [t looked so right 
) 


List<Dog> cannot be converted to List<Animal> 
takeAnimals (dogs) ; 


A 


but went so wrong... 


1 error 
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And I'm supposed 
to be OK with this? That totally 
screws my animal simulation where the 

veterinary program takes a list of any type 
of animal so that a dog kennel can send a list 
of dogs, and a cat kennel can send a list of 
cats...now you're saying I can't do 
that? 


What could happen if it were allowed...? 


Imagine the compiler let you get away with that. It let you pass a 
List<Dog> to a method declared as: 


public void takeAnimals (List<Animal> animals) { 
for (Animal a : animals) { ~ 
a.eat(); 
} 
} 


There’s nothing in that method that /ooks harmful, right? After all, the 
whole point of polymorphism is that anything an Animal can do (in this 
case, the eat() method), a Dog can do as well. So what’s the problem with 
having the method call eat() on each of the Dog references? 


There’s nothing wrong with that code. But imagine this code instead: 


public void takeAnimals (List<Animal> animals) { 
animals.add(new Cat()); © Yikes!! We just stuck a Cat in what 
might be a Dogs—only List. 


So that’s the problem. There’s certainly nothing wrong with adding a Cat to 
a List<Animal>, and that’s the whole point of having a List of a supertype 


} 


like Animal—so that you can put all types of animals in a single Animal List. 


But if you passed a Dog List—one meant to hold ONLY Dogs—to this 
method that takes an Animal List, then suddenly you’d end up with a Cat in 
the Dog list. The compiler knows that if it lets you pass a Dog List into the 
method like that, someone could, at runtime, add a Cat to your Dog list. So 
instead, the compiler just won’t let you take the risk. 


If you declare a method to take 
List<Animal>, it can take ONLY a 
List<Animal>, not List<Dog> or List<Cat>. 
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It seems to me there 
should be a way to use polymorphic 
collection types as method arguments 
so that a vet program could take 

Dog lists and Cat lists. Then it would be 
possible to loop through the lists and call 
their immunize() method. It would have 
to be safe so that you couldn't add a 
Cat in to the Dog list. 


A 
EA 
Pea 4 
\ 


(a) 
a a a 

We can do this with wildcards 

It looks unusual, but there zs a way to create a method argument that 

can accept a List of any Animal subtype. The simplest way is to use a 

wildcard. 

public void takeAnimals (List<? extends Animal> animals) { 

for (Animal a : animals) { » ; 
a.eat(); Remember, the keyword re ii $ 
} means either extends OR implements: 
} W 
w 

So now you’re wondering, “What’s the difference? Don’t you have the i | 

same problem as before?” 

And you’d be right for wondering. The answer is NO. When you use = = 

the wildcard <?> in your declaration, the compiler won't let you do g’ 3 

anything that adds to the list! 4 
When you use a wildcard in your there, are no 4 
method argument, the compiler will pum Questions 
STOP you from doing anything that - . 
could hurt the list referenced by the : Back when we first saw generic methods, there was 
method parameter. a similar-looking method that declared the generic type in 

front of the method name. Does that do the same thing as this 

You can still call methods on the takeAnimals method? 


elements in the list, but you cannot 
add elements to the list. 


A: Well spotted! Back at the start of the chapter, there was a 
In other words, you can do things with method like this: 


the list elements, but you can’t put <T extends Animal> void takeThing(List<T> list) 
new things in the list. 

We actually could use this syntax to achieve a similar thing, but it 
works in a slightly different way. Yes, you can pass List<Animal> 
and List<Dog> into the method, but you get the added benefit 
of being able to use the generic type, T, elsewhere too. 


youarehere> 361 


generic methods 


Using the method's generic type parameter 


What can we do if we define our method like this instead? 


public <T extends Animal> void takeAnimals(List<T> list) { } 


Well, not much as the method stands right now, we don’t need to use “T” for anything. But if we 
made a change to our method to return a List, for example of all the animals we had success- 
fully vaccinated, we can declare that the List that’s returned has the same generic type as the 
List that’s passed in: 


public <T extends Animal> List<T> takeAnimals(List<T> list) { } 


When you call the method, you know you're going to get the same type back as you put in. 


the 
ck from 
List<Dog> dogs = List.of(new Dog(), new Dog()); The List we ae as always the 
List<Dog> vaccinatedDogs = takeAnimals (dogs) ; kakehrim? = Khe list we pass 


same CYP 
List<Animal> animals = List.of(new Dog(), new Cat()); 
List<Animal> vaccinatedAnimals = takeAnimals (animals) ; 


If the method used the wildcard for both method parameter and return type, there’s nothing to 
guarantee they’re the same type. In fact, anything calling the method has almost no idea what’s 
going to be in the collection, other than “some sort of animal.” 


public void go() { 
List<Dog> dogs = List.of (new Dog(), new Dog()); 
List<? extends Animal> vaccinatedSomethings = takeAnimals (dogs) ; 


public List<? extends Animal> takeAnimals (List<? extends Animal> animals) { } 


Using the wildcard (“? extends”) is fine when you 
don’t care much about the generic type, you just 
want to allow al] subtypes of some type. 


Using a type parameter (“T”) is more helpful when 
you want to do more with the type itself, for 
example in the method’s return. 
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BE the Compiler, advanced 


Your job is to play compiler and determine which of these statements would compile. 
Some of this code wasn't covered in the chapter, so you need to work out the answers 
based on what you DID learn, applying the “rules” to these new situations. 


The signatures of the methods used in the exercise are in the boxes. 


Private void takeDogs (List<Dog> dogs) { } 
private void takeAnimals(List<Animal> animals) { } | 
private void takeObjects (ArrayList<Object> objects) { | 
Compiles? 


takeAnimals (new ArrayList<Animal>()); 


takeDogs (new ArrayList<Animal> () ); 


takeAnimals (new ArrayList<Dog> () ); 


takeDogs (new ArrayList<>()); 


List<Dog> dogs = new ArrayList<>(); 
takeDogs (dogs) ; 


takeSomeAnimals (new ArrayList<Dog> ()) ; 


takeSomeAnimals (new ArrayList<>()); 


takeSomeAnimals (new ArrayList<Animal> () ); 


List<Animal> animals = new ArrayList<>(); 
takeSomeAnimals (animals); 


List<Object> objects = new ArrayList<>(); 
takeObjects (objects) ; 


takeObjects (new ArrayList<Dog> () ); 


OO O OOWOW YWUUUUU 


takeObjects (new ArrayList<Object>()); 


Answers on page 367. 
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Exercise Solution Fill- in-the-blanks (from page 334) 


Possible Answers: 
Comparator, 
Comparable, 

compareTo( ), 
compare( ), 
yes, 
no 


Given the following compilable statement: 


Collections.sort (myArrayList) ; 


1. What must the class of the objects stored in myArrayList implement? 
2. What method must the class of the objects stored in myArrayList implement? 


3. Can the class of the objects stored in myArrayList implement both 
Comparator AND Comparable? 


Given the following compilable statement: 


Collections.sort (myArrayList, myCompare) ; 


4. Can the class of the objects stored in myArrayList implement Comparable? 
5. Can the class of the objects stored in myArrayList implement Comparator? 
6. Must the class of the objects stored in myArrayList implement Comparable? 
7. Must the class of the objects stored in myArrayList implement Comparator? 


8. What must the class of the myCompare object implement? 


9. What method must the class of the myCompare object implement? 
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compareTo( ) 


yes 


yes 


yes 


no 


no 


Comparator 


compare( ) 
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Solution “Reverse Engineer” Jambdas exercise 
a your pencil (from page 343) 


import java.util.*; 


public class SortMountains { 
public static void main(String[] args) { 
new SortMountains().go(); 


public void go() { 


List<Mountain> mountains = new ArrayList<>(); 
mountains.add(new Mountain("Longs", 14255)); 
mountains.add(new Mountain("Elbert", 14433)); 
mountains.add(new Mountain("Maroon", 14156) ) 
mountains.add(new Mountain("Castle", 14265)); 


System.out.print] 


r 


In("as entered:\n" + mountains); 


mountains .sort ((mount1, mount2) -> mount1.name.compareTo(mount2 .name)) ; 
System.out.println("by name:\n" + mountains); 


mountains.sort((mount1, mount2) -> mount2.height - mount! .height); 


System.out.printlin("by height:\n" + mountains); 


ioht list is 
| id You notice that the he ah 
x DESCENDIN G sequence? 


class Mountain { 
String name; 
int height; 


Mountain(String name, int height) { 
this.name = name; 


this.height = height; Output: 
} 
public String toString( ) í %java SortMountains 

return name + "" + height; as entered: 
} [Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 


} by name: 
[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 
by height: 
[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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Solution Sorting with lambdas 
eres Seas 
Sort by BPM ascending 
songList.sort((one, two) -> one.getBpm() - two.getBpm() ) ; 
S ; 
ort by title descending 


songList.sort((one, two) -> two.getTitle() .compareTo(one.getTitle())); 


Output: 


File Edit Window Help IntNotString 
%Sjava SharpenLambdas 


[50 ways, havana, $10, somersault, cassidy, Cassidy] 


[somersault, havana, cassidy, Cassidy, 50 ways, $10] 


Solution | TreeSet exercise 
ogee your pencil (from page 353) 


1. What is the result when you compile this code? 


It compiles correctly 


2. If it compiles, what is the result when you run the TestTree class? 


It throws an exception: 


Exception in thread "main" java.lang.ClassCastException: class Book can- 
not be cast to class java.lang.Comparable 

at java.base/java.util.TreeMap.compare (TreeMap. java:1291) 

at java.base/java.util.TreeMap.put (TreeMap. java: 536) 

at java.base/java.util.TreeSet .add(TreeSet . java: 255) 

at TestTree.go(TestTree.java:16) 

at TestTree.main (TestTree.java:7) 


3. If there is a problem (either compile-time or runtime) with this code, how would you fix it? 


Make Book implement Comparable, or pass the TreeSet a Comparator 


See page 514 
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BE the Compiler solution 


(from page 363) 


Compiles? 


takeAnimals (new ArrayList<Animal>() ); 


K 


takeDogs (new ArrayList<Animal> () ); 

takeAnimals (new ArrayList<Dog> () ); a erator here tw A e 
the tyle 

takeDogs (new ArrayList<>()); L~ ~~a signature: There 


List<Dog> dogs = new ArrayList<>() ; peraylis 
takeDogs (dogs); 


takeSomeAnimals (new ArrayList<Dog> () ) ; H 
ere the diamond 
takeSomeAnimals (new ArrayList<>()) ; £— operator means this is 


AvvayList<Animal 
takeSomeAnimals (new ArrayList<Animal> () ); 
List<Animal> animals = new ArrayList<>(); 
takeSomeAnimals (animals) ; 

’ I} core ile because 
This doesn an 

List<Object> objects = new ArrayList<>(); bakedbyetts waw ok 
takeObjects (objects) ; PrerayLists not 3 


takeObjects (new ArrayList<Dog> () ); 


KE C ERRE EEL 


takeObjects (new ArrayList<Object>()); 
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Lambdas and Streams: 
What, Not How 


Did you know, you 
don't have to write absolutely 
everything yourself? You can 

get the APIs to do the work 
for you! 


What if...you didn’t need to tell the computer HOW to do 
something? Programming involves a lot of telling the computer how to do something: 


while this is true do this thing; for all these items if it looks like this then do this; and so on. 


We've also seen that we don’t have to do everything ourselves. The JDK contains library code, 
like the Collections API we saw in the previous chapter, that we can use instead of writing 
everything from scratch. This library code isn’t just limited to collections to put data into; there 
are methods that will do common tasks for us, so we just need to tell them what we want and 


not how to do it. 


In this chapter we'll look at the Streams API. You'll see how helpful lambda expressions can be 
when you're using streams, and you'll learn how to use the Streams API to query and transform 


the data in a collection. 


this is a new chapter 369 


what not how 


Tell the computer WHAT you want 


Imagine you have a list of colors, and you wanted to print out all the colors. You 
could use a for loop to do this. 


method” for ere se J e 
ore: cer ris in Chapter Il. 


List<String> allColors = List.of("Red", "Blue", "Yellow") ; 


for (String color : allColors) { 
for loop ( 


For eath item in the list create a 


System. out .print1n (color); temporary variable, tolor- 
} 


~-then print out eath color. 


But doing something to every item in a list is a really common thing to want to do. 
So instead of creating a for loop every time we want to do something “for each” 
item in the list, we can call the forEach method from the Iterable interface— 
remember, List implements Iterable so it has all the methods from the Iterable 
interface. 


List<String> allColors = List.of("Red", "Blue", "Yellow"); 
allColors.forEach(color -> System.out.printiln (color)); 
a a 


Create a temporary 
variable named tolor 
an mete Print out the color 


the list--- 
The forEach method of a list takes a 
lambda expression, which we saw for the 


%java PrintColors first time in the previous chapter. This 

Red is a way for you to pass behavior (Follow 

Blue these instructions”) into a method, 

canis instead of passing an object containing 
data (“here is an object for you to use”). 
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a Chats Tonight’s Talk: The for loop and forEach 
& >J method battle over the question, “Which is 
) better?” 
> 
= Y 
for loop forEach() 


Tam the default! The for loop is so important 

that loads of programming languages have me. 

It’s one of the first things a programmer learns! 

If someone needs to loop a set number of times 

to do something, they’re going to reach for their 

trusty for loop. 
Pf. Please. You are so old, that’s why you’re in all 
the programming languages. But things change, 
languages evolve. There’s a better way. A more 
modern way. Me. 


Sure, fashions change. But sometimes it’s just a 
fad; things fall out of fashion too. A classic like 
me will be easy to read and write forever, even for 


non-Java programmers. 
But look how much work developers need to do to 


write you! They have to control when to start, in- 
crement, and stop the loop, as well as writing the 
code that needs to be run inside the loop. All sorts 
of things could go wrong! If they use me, they just 
have to think about what needs to happen to each 
item, they don’t have to worry about how to loop 
to find each item. 


So much work?! Ha! A developer isn’t scared of a 
little syntax to clearly specify what to do and how 
to do it. At least with me, someone reading my 


code can clearly see what's going on. Dude, they shouldn’t have to see what’s going on. 


It says very clearly in my method name exactly 
what I do—“for each” element I will apply the 
logic they specify. Job done. 


Well I’m faster. Everyone knows that. : 
Well actually, under the covers I’m using a for 


loop myself, but if something is invented later 
that’s even faster, I can use that, and developers 
don’t have to change a single thing to get faster 
code. In fact we’re out of time now so.... 

I said you would disappear soon. 
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When for loops go wrong 


Using forEach instead of a for loop means a bit less typing, and it’s also nice 

to focus on telling the compiler what you want to do and not how to do it. There’s 
another advantage to letting the libraries take care of routine code like this—it can 
mean fewer accidental errors. 


A short Java program is listed below. One block of the program is 
missing. We expect the output of the program should be“1 2345” 
but sometimes it’s difficult to get a for loop just right. 


Mixed Your challenge is to match the candidate block of code (on the left) 

Messages with the output that you'd see if the block were inserted. Not all the 
lines of output will be used, and some of the lines of output might be 
used more than once. 


class MixForLoops { 
public static void main(String [] args) { 
List<Integer> nums = List.of(1, 2, 3, 4, 5); 
String output = ""; 


C. : 
andidate Code 
Joes here 
System.out.printin(output) ; 
} 
} 
Candidates: Possible output: 
for (ant 2 = 1; 2 =< nums.size{); i++) 
output += nums.get(i) +" "; L233 45 


Compiler error 
for (Integer num : nums) p 


output += nums + " "; 


23 A5 


for (int i = 0; i <= nums.length; i++) 7 
í ead Exception thrown 


output += nums.get(i) +" "; 
[ie 2p Sp Ar SI 
for (int i = 0; i <= nums.size(); i++) ao aa a 
output += nums.get(i) + " "; p @p Ba “ry 
[ip 27 3, 4 5] 
Dilip 2, 3; 4r 5] 
[ie 2, Sp Ap 5] 


———> Answers on page 417. 
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Small errors in common code can be hard to spot 


The for loops from the previous exercise all look quite similar, and at first glance they all look 
like they would print out all the values in the List in order. Compiler errors can be easiest to 
spot, because your IDE or compiler will tell you the code is wrong, and Exceptions (which 
we'll see in Chapter 13, Risky Behavior) can also point to a problem in the code. But it can be 
trickier to spot code that produces incorrect output just by looking at the code. 


Using a method like forEach takes care of the “boilerplate,” the repetitive and common 
code like the for loop. Using forEach, passing in only the thing we want to do, can reduce 
accidental errors in our code. 


If we can ask the API to do 
something “for each element," it 
seems like there are other common 
tasks that we could get the API to do 
for us. 


Yes absolutely, in fact Java 8 
introduced a whole API just for this. 


Java 8 introduced the Streams API, a new set b 2 
of methods that can be used on many classes, y 6 
including the Collections classes we looked at in 

the previous chapter. 


The Streams API isn’t just a bunch of helpful 
methods, but also a slightly different way of 
working, It lets us build up a whole set of 
requirements, a recipe if you like, of what we 
want to know about our data. 


ZD) 


Can you think of more examples of the types of 


things we might want to do to a collection? Are 
you going to want to ask similar questions about 
what’s inside different types of collections? Can 
you think of different types of information you 
might want to output from a collection? 


youarehere> 373 


common collection operations 


Building blocks of common operations 


The ways we search our collections, and the types of information we want to output from those 
collections, can be quite similar even on different types of collections containing different types of 


Objects. 


Imagine what you might want do to with a Collection: “give me just the items that meet some crite- 


33 cc 


ria,” “change all the items using these steps, 


33 66 


remove all duplicates,” and the example we worked 
through in the previous chapter: “sort the elements in this way.” 


It’s not too hard to go one step further and assume each of these collection operations could be 
given a name that tells us what will happen to our collection. 


O: a 
WAS BCE: WHAT? 


We know this is all new, but have a go at matching each operation name 
to the description of what it does. Try not to look at the next page as you 
complete it, as that will give the game away! 


filter Changes the current element in the 
stream into something else 


Sets the maximum number of elements 


ski 
P that can be output from this Stream 
limit While a given criteria is true, will not 
process elements 
distinct Only allows elements that match the 
given criteria to remain in the Stream 
sorted Will only process elements while the 
~ given criteria is true 
map States the result of the stream should 
be ordered in some way 
dr op While This is the number of elements at the start 
g of the Stream that will not be processed 
takeWhile Use this to make sure duplicates are removed 


———— Answers on page 417. 
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Introducing the Streams API 


The Streams API is a set of operations we can perform on a collection, so when we 
read these operations in our code, we can understand what we’re trying to do with 
the collection data. If you were successful in the “Who Does What?” exercise on the 


previous page (the complete answers are at the end of this chapter), you should have 
seen that the names of the operations describe what they do. 


(These are yst a few of 
the methods in Stream.. 
there are many more: 


java.util.stream.Stream 


> distinct() i tinct elements 
Stream<T ener consisting of the distin 
Returns 


redicate) 
i ? super T> p : dicate. 
edicate<: ven predi 
Stream<T> ae the elements that match the gi 
Returns a strea 


These generi¢s do look 
a little intimidating, 
but don’t panic! We'll 
use the map method 
later, and you'll see it’s 


not as complicated as 
it seems. 


e ize) han max- 
; lon maxSi longer t 
Stream<T> na of eai truncated to be no 

Returns a stre 

size in length. 


er) 
2 extends R> mapp 
R map(Function<? super kA nm ete 
sd a 4 m with the results of applying the g 
eturns a streal 
PADEM of this stream. 


Stream<T> skip(long n) 


discarding the first n elements of the stream. 


ing to 
d . rted according 
Stream<T> T iA the elements of this stream, SO 
m 
Returns a strea 
natural order. 


I| more 


Relax 


You don’t need to worry too 
much about the generic types 
n the Stream methods; "ll 
Streams, and lambda expressions, | | see ia aera Gace 
were introduced in Java 8. 


see that using Streams “just 
works” the way you’d expect. 


In case you are interested: 


e <T> is usually the Type of the object in the stream. 


e <R> is usually the type of the Result of the method. 
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Getting started with Streams 


Before we start going into detail about what the Streams API is, what it does, and how to 
use it, we’re going to give you some very basic tools to start experimenting. 


To use the Streams methods, we need a Stream object (obviously). If we have a collection 
like a List, this doesn’t implement Stream. However, the Collection interface has a 


Assuming we had a List of 
Sings like this- 


method, stream, which returns a Stream object for the Collection. 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 
Stream<String> stream = strings.stream(); 
SS ee 


we ĉan call this method to get 
a Stream of these Strings. 
Now we can call the methods of the Streams API. For example, we could use limit 

to say we want a maximum of four elements. 


Stream<String> limit = stream.limit (4) ; 
ag —— Sets the maximum number of 


N results to return to 4 


The limit method returns 
another Stream of Strings, 
which we'll assign to another 
variable 


What happens if we try to print out the result of calling limit()? 


System.out.printin("limit = " + limit); 


File Edit_Window Help SliceAndDice 


$java LimitWithStream 


limit = java.util.stream.SliceOps$1@7a0ac6e3 


This doesn’t look right at all! What’s a 


SliceOps, and why isn't there a collection 
=— of ia the vst four items from the list? 


Like everything in Java, the stream variables in the example are Objects. But a stream 
does not contain the elements in the collection. It’s more like the set of instructions 
for the operations to perform on the Collection data. 


Stream methods that return another Stream are called 
Intermediate oey These are instructions of things to 
, but they don’t actually perform the operation on their own. 
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What's the point 
of having a method 
called limit if it doesn't 
actually limit my results? 
How am I supposed to see 
the output of the 
method? 


Streams are like recipes: nothing's going to 
happen until someone actually cooks them 


WN a “do it 
re get the cake, 
ov there is 

` nô tak e. 


A recipe in a book only tells someone how to cook or bake something. 
Opening the recipe doesn’t automatically present you with a freshly 
baked chocolate cake. You need to gather the ingredients according 


to the recipe and follow the instructions exactly to come up with the 
result you want. 


Collections are not ingredients, and a list limited to four entries is not a 

chocolate cake (sadly). But you do need to call one of the Stream’s “do it” methods 
in order to get the result you want. These “do it” methods are called Terminal 
Operations, and these are the methods that will actually return something to you. 


(These are some 
terminal operations on 
Chream.) 


java.util.stream.stream 


Yes, this looks even 
scarier than the map 
method! Don’t Panic, 
these generit types help 
the compiler, but ou ll 
see when we actually use 
this method, we don't 
have to think about 
these generic types. 


dicate) 
; ? super T> pre 
tch(Predicate< 
boolean anyMa 


y p de d pr te. 
edica e 

Re rn: tr if aly element matches the rovi 

turns ue 


i is stream. 
long count) number of elements 1N this 
Returns 


> collector) 
7 super TAR of this 
ollector<: . lements 
RA a reduction operation on the e 
Performs a 
i Collector. 
stream using 4 an 
: irst() f this stream, © 
Optional<T node | describing the first element © 
Returns an Optiona oty. 


|| more 
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Getting a result from a Stream 


Yes, we’ve thrown a lot of new words at you: streams; intermediate operations; terminal operations... 
And we still haven’t told you what streams can do! 


To start to get a feel for what we can do with streams, we going to show code for a simple use 
of the Streams API. After that, we'll step back and learn more about what we’re seeing here. 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


Stream<String> stream = strings.stream() ; 

Stream<String> limit = stream. limit (4) ; 

long result = limit.count() ; Call the count terminal 

System.out.printin("result = " + result); operator, and store the output 
in a variable called result 


$java LimitWithStream 


result 


This works, but it’s not very useful. One of the most common things to do with Streams 
is put the results into another type of collection. The API documentation for this method 


might seem intimidating with all the generic types, but the simplest case 1s straightforward: ettor 
. ns a US 
The stream contained Strings, Terminal operation th Tvis method ee vests 
so the output object will also will college the out: i hat A we a ast 
contain Strings. Some sort of Object. me ibe stream ™ 
List<String> result = limit.collect (Collectors .toList()); 
The a hat contains methods to 
will oo rr [ellector A helpful class potent implementations 
as a List, ° ae cen 
System.out.printlin("result = " + result); 


Relax We’ll see collect() and the 


Collectors in more detail 


later. 


$java LimitWithStream 


For now, collect (Collectors. 
toList) is a magic incantation 


result = [I, am, a, list] to get the output of the stream 


pipeline in a List. 


Finally, we have a result that looks like something we would have expected: we had a 
List of Strings, and we asked to limit that list to the first four items and then collect 
those four items into a new List. 
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Stream operations are building blocks 


We wrote a lot of code just to output the first four elements in the list. We also 
introduced a lot of new terminology: streams, intermediate operations, and terminal 
operations. Let’s put all this together: you create a stream pipeline from three 
different types of building blocks. 


© Get the Stream from a source collection. 


.stream() 


collection —~—> 


Call zero or more intermediate operations on the 
Stream. 


© Output the results with a terminal operation. 


.collect () = output 


You need at least the first and last pieces of the puzzle to use the Streams API. 
However, you don’t need to assign each step to its own variable (which we were doing on 
the last page). In fact, the operations are designed to be chained, so you can call one 
stage straight after the previous one, without putting each stage in its own variable. 


On the last page, all the building blocks for the stream were highlighted (stream, limit, 
count, collect). We can take these building blocks and rewrite the limit-and-collect 
operation in this way: 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings"); 


Get the stream for the eollection 


List<String> result = strings.stream() Cet a limit to return a maximum of 
_—> |. Limit wW 4 vesults from the stream 


Formatted to align each operation .collect (Collectors .toList ()); 
directly underneath the one above, aN BE ons Bes 
to clearly show each stage. “a Neat of the 


System.out.printin("result = " + result); 
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Building blocks can be stacked and combined 


Every intermediate operation acts on a Stream and returns a Stream. That means you 
can stack together as many of these operations as you want, before calling a terminal 
operation to output the results. 


“Lal The source, the intermediate 
rd operation(s), and the terminal 


r | operation al] combine to form a 
Stream Pipeline. This pipeline 
Tepresents a query on the 
Te! origina] collection. 


This is where the Streams API becomes really useful. In the earlier example, we 
needed three building blocks (stream, limit, collect) to create a shorter version of the 
original List, which may seem like a lot of work for a simple operation. 


But to do something more complicated, we can stack together multiple operations in 
a single stream pipeline. 


For example, we can sort the elements in the stream before we apply the limit: 
List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


List<String> result = strings.stream() cat sits Sihi stream (not the 
ý . a 
-sorted () =— original collection), using natur its 
Limit the stream to just order, before limiting Fhe resu 
_ Ff 


our elements. .limit (4) 


.collect (Collectors .toList ()); 


System. out .printin ("result = " + result); 


% java ChainedStream 


Natural ordering of Strings will 


lace capitali i 
result = [I, Strings, a, am] — heres oo ahead of 
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Customizing the building blocks 


We can stack together operations to create a more advanced query on our collection. 
We can also customize what the blocks do too. For example, we customized the Limit 
method by passing in the maximum number of items to return (four). 


If we didn’t want to use the natural ordering to sort our Strings, we could define a specific 
way to sort them. It’s possible to set the sort criteria for the sorted method (remember, 
we did something similar in the previous chapter when we sorted Lou’s song list). 


how to sort the st 


about in th . 
recap lambdas aie in this chor pate We’ll 


List<String> result = strings.stream() 
.sorted( (s1, s2) -> s1.compareToIgnoreCase (s2)) 
.limit (4) 


.collect (Collectors.toList()); This method re the plies 
ares the String wi 
Chee in a way that ignores upper 


File Edit Window Help IgnoreCaps or lowercase- 
%java ChainedStream 


result = [a, am, I, list] 


Create complex pipelines block by block 


Each new operation you add to the pipeline changes the output from the pipeline. Each 
operations tell the Streams API what it is you want to do. 


List<String> result = strings.stream() 
-sorted((sl, s2) -> sl.compareToIgnoreCase(s2) ) 
. skip (2) 
- limit (4) 
-collect (Collectors.toList()); 


%java ChainedStream 


The stream skipped he f; 
= two elements. PEAN pene ee 


result = [I, list, of, Strings] 
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With these longer stream 
pipelines, I guess you don't want the 
computer to run off and perform each 
operation individually and then come back to 
perform the next one, right? So the reason we 
needed a terminal operation was so the library “does 
it" ONLY when it knows ALL the operations in 
the pipeline? 


Yes, because Streams are lazy 


That doesn’t mean they’re slow or useless! It means that each intermediate 
i | operation is just the instruction about what to do; it doesn’t perform the 
eS, instruction itself. Intermediate operations are lazily evaluated. 


The terminal operation is responsible for looking at the whole list of instructions, 
all those intermediate operations in the pipeline, and then running the whole set 
together in one go. Terminal operations are eager; they are run as soon as they’re 


called. 


This means that in theory it’s possible to run the combination of instructions in 
the most efficient way. Instead of having to iterate over the original collection 
for each and every intermediate operation, it may be possible to do all the 
operations while only going through the data once. 


T only start my day 
once I know exactly 
what I'm going to do, and 
exactly how to do it. 
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a a 
Terminal operations do all the work 
Since intermediate operations are /azy, it’s up to the terminal operation to do everything. 


Perform all the intermediate operations as efficiently as possible. Ideally, just going 
through the original data once. 


Work out the result of the operation, which is defined by the terminal operation itself. 
For example, this could be a list of values, a single value, or a boolean (true/false). 


Q Return the result. 


Collecting to a List 


Now that we know more about what’s going on in a terminal operation, let’s take a 
closer look at the “magic incantation” that returns a list of results. 


ne 
that has stati 
Collectors 'S i a dikteret 
e ions oÑ Colecta aie 
implemen elass bi 
List<String> result = strings.stream() at 7 ee to collett up the 
.sorted() most tomm 
.skip (2) vesults: 
Tan. .limit (4) 
l ey Operation: .collect (Collectors .toList ()); 
in fyrtorms all j lector, 
h this Case: sav ittrmediate operati The collect method hore n 
Fj ĉolleets the pe, us” limit. 4 the recipe for how to Pui a 
he instruction lts Alor; the results. In this a ‘eae 
3. ved ns Passed inf, ! ang to k elpful predefined Col ett ri 
“rns those results puts the cesults into a List. 


We will look at more Collectors, and 
other terminal operations, later in the 
chapter. For now, you know enough to 

get going with Streams. 


youarehere» 383 


working with streams 


Guidelines for working with streams 


Like any puzzle or game, there are rules for getting the stream building blocks to work 
properly. 


© You need at least the first and last pieces to ee al 
create a stream pipeline. 
Without the stream () piece, you don’t get a Stream at all, and without | z 
the terminal operation, you're not going to get any results. ‘a 


©) You can’t reuse Streams. 


It might seem useful to store a Stream representing a query, and reuse it in multiple places, either 
because the query itself is useful or because you want to build on it and add to it. But once a terminal 
operation has been called on a stream, you can’t reuse any parts of that stream; you have to create a 
new one. Once a pipeline has executed, that stream is closed and can’t be used in another pipeline, 


even if you stored part of it in a variable for reusing elsewhere. If you try to reuse a stream in any way, 
you'll get an Exception. 


Stream<String> limit = strings.stream() 

. Limit (4) ; 
List<String> result = limit.collect (Collectors .toList ()); 
List<String> result2 = limit.collect (Collectors .toList () ); 


File Edit Window Help ClosingTime 
% java LimitWithStream 


Exception in thread "main" java.lang.IllegalStateException: stream has 


already been operated upon or closed 


at java.base/java.util.stream.AbstractPipeline. 
evaluate (AbstractPipeline.java:229) 


You can’t change the underlying collection 
while the stream is operating. 

If you do this, you’ll see strange results, or exceptions. ‘Think 
about it—if someone asked you a question about what was 
in a shopping list and then someone else was scribbling on 
that shopping list at the same time, you’d give confusing 
answers too. 


I'm so confused! 
I'm just trying to 
read this list, but 
it keeps changing! 
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So if you shouldn't 
change the underlying 
collection while you're 

querying it, the stream 
operations don't change the 
collection either, right? 


> Correct! Stream operations don't change the original collection. 


The Streams API is a way to query a collection, but it doesn’t make changes to the 
collection itself You can use the Streams API to look through that collection and return 
results based on the contents of the collection, but your original collection will remain 
the same as it was. 


This is actually very helpful. It means you can query collections and output the results 
from anywhere in your program and know that the data in your original collection is 
safe; it will not be changed (“mutated”) by any of these queries. 


You can see this in action by printing out the contents of the original collection after 
using the Streams API to query it. 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


Stream<String> limit = strings.stream() 

. Limit (4) 

.collect (Collectors .toList ()); 
System.out.printin("strings = " + strings); 
System.out.printin("result = " + result); 


$java LimitWithStream 


No changes to original 
collection after the stream 


strings = [I, am, a, list, of, Strings] ‘ 
operations are run. 


result = [I, am, a, list] 


Only the output ol jett has the 
results of the query. This is a 
brand new List. 
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er Code Magnets 


255 J A Java program is all scrambled up on the fridge. 
> Can you reconstruct the code snippets to make a 

working Java program that produces the output 
listed below? 


.distinct () j 


System. out .print1n( coffeesEndingIn0O) ; 


public class CoffeeOrder { 
public static void main (String[] args) { 


List<String> coffees = List.of("Cappuccino", 
"Americano", "Espresso", "Cortado", "Mocha", 
"Cappuccino", "Flat White", "Latte"),; 


import java. util.*; 


List<String> coffeesEndingiInoO = coffees. stream () 


impo ; 
rt Java.util. stre = 
aa 


%$java CoffeeOrder 


[Americano, Cappuccino, Cortado, Espresso] 


——> Answers on page 418. 
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Dumb Questions 


Q: Is there a limit to the number of intermediate operations | can put 
in a stream pipeline? 


A: No, you can keep chaining these operations as much as you like. But 
do remember that it's not just computers that have to read and understand 
this code; it’s humans too! If the stream pipeline is really long, it might be 
too complicated to understand. That's when you might want to split it up and 
assign sections to variables, so you can give these variables useful names. 


Q: Is there any point in having a stream pipeline without 
intermediate operations? 


A: Yes, you might find that there’s a terminal operation that outputs the 
original collection in some new shape, which is just right for what you need. 
Be aware, however, that some of the terminal operations are similar to 
methods that exist on the collection; you don’t always need to use streams. 
For example, if you're just using count ona Stream, you could probably 
use size instead, if your original collection is a List. Similarly, anything that 
is Iterable (like List) already has a forEach method; you don’t need to use 
stream() .forEach (). 


Q: You said not to change the source collection while the stream 
operation is in progress. How is it possible to change the collection 
from my code, if my code is doing a stream operation? 


A: Great question! It’s possible to write programs that run different bits of 
code at the same time. We'll learn about this in Chapters 17 and 18, which 
cover concurrency. To be safe, it’s usually best (not just for Streams, but in 
general) to create collections that can’t be changed if you know they don’t 
need to be changed. 


Q: How can | output a List that can’t be changed from the collect 
terminal operation? 


A: If you’re using Java 10 or higher, you can use Collectors. 
toUnmodifiableList, instead of using Collectors .toList, 
when you call collect. 


Q: Can I get the results of the stream pipeline in a collection that 
isn’t a List? 


A: Yes! In the previous chapter we learned that there are a few different 
kinds of collections for different purposes. The Collectors class has 
convenience methods for collecting toList, toSet, and toMap, as well 
as (since Java 10) toUnmodifiableList, toUnmodifiableSet, 
and toUnmodifiableMap. 
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lambdas and streams 


You don't have to write detailed code 
telling the JVM exactly what to do 
and how to do it. You can use library 
methods, including the Streams API, 
to query collections and output the 
results. 


Use forEach on a collection instead 
of creating a for loop. Pass the method 
a lambda expression of the operation 
to perform on each element of the 
collection. 


Create a stream from a collection 
(a source) by calling the stream 
method. 


Configure the query you want to run 
on the collection by calling one or 
more intermediate operations on the 
stream. 


You won't get any results until you 
call a terminal operation. There 

are a number of different terminal 
operations depending upon what you 
want your query to output. 


To output the results into a new List, 
use collect (Collectors. 
toList) as the terminal operation. 


The combination of the source 
collection, intermediate operations, 
and terminal operations is a stream 
pipeline. 


Stream operations do not change 

the original collection; they are a way 
to query the collection and return a 
different Object, which is a result of the 


query. 
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Hello Lambda, my (not so) old friend 


Lambda expressions have cropped up in the streams examples so far, and you can bet 
your bottom dollar (or euro, or currency of your choice) that you’re going to see more 
of them before this chapter is done. 


Having a better understanding of what lambda expressions are will make it easier to 
work with the Streams API, so let’s take a closer look at lambdas. 


Passing behavior around 


If you wrote a forEach method, it might look something like this: 


void forEach( ???7?? ) { 
for (Element element : list) { 


This is the ş 
Pace wh 
eee - block of Code to le ai 


| every list element would go. 


the block of code that’s going to go into that nice, blank square. 


Then you want someone calling the method to be able to say: 


forEach (do this: | System. out .print1n( iem ) D; 


You tant just write this code 
here, because it will be run 


. ds to somehow get 
straightaway. Instead, we This code nee int ity 
: b hand this block hold of the element to print i 


d ; m 
oe to the forEach but how ĉan it yt NSIDE Ge 
method so that method can call when that code 5 


2 
it when it’s ready. forEath method! 


Now, we need to replace the do this with some sort of symbol to represent that this 
code isn’t to be run straightaway, but instead needs to be passed into the method. We 
could use, oh, let’s see... “->” as this symbol . 


Then we need a way to say “look, this code is going to need to work on values from 
elsewhere.” We could put the things the code needs on the left side of the “do this” 
symbol... 


Hey, I know 
forEach(|/item -> System. out.printin (item) p ; you, you're a lambda 
expression! 
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OK, so now I get that 
the lambda I pass in as a 
method argument is somehow used 
in the body of that method. But 

what is the lambda? How can the 
method USE this chunk of code 
I just passed it? 


Lambda expressions are objects, and you run them by calling 
their Single Abstract Method 


Remember, everything in Java 1s an Object (well, except for the primitive types), and 
lambdas are no exception. 


A lambda expression implements a Functional Interface. 


This means the reference to the lambda expression 1s going to be a Functional Inter- 
face. So, if you want your method to accept a lambda expression, you need to have a 
parameter whose type is a functional interface. That functional interface needs to be 
the right “shape” for your lambda. 


Back to our imaginary forEach example; our parameter needs to implement a 
Functional Interface. We also need to call that lambda expression somehow, passing 
in the list element. 


Remember, Functional Interfaces have a Single Abstract Method (SAM). It’s this 
method, whatever its name is, that gets called when we want to run the lambda code. 


i i of what the 
is i type to give You an idea 
ny Flacco te Wel iA at specifie Functional 


Interfaces throughout this chapter: 


void forEach( SomeFunctionalInterface lambda ) { 
for (Element element : list) { 


.singl MethodN. 1 ; . i 
lambda. singleAbstractMethodName (element) ; “element” is the lambda’s 


' N arameter, the “item” in 
hi The lambda expression on 
Is Wo 
whaler a name the last page 
pistract Metho s, inl Lambdas aren't magic: 
unttiong] inter. Die the 


they're just classes 
like everything else. 
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The shape of lambda expressions 


We've seen two lambda expressions that implement the Comparator interface: the 
example for sorting Lou’s songs in the previous chapter, and the lambda expres- 
sion we passed into the sorted () stream operation on page 381. Look at this last 
example side by side with the Comparator Functional Interface. 


Comparator Interface Lambda expression (implements Comparator) 
public interface Comparator<T> { 
int compare(T ol, T 02); (s1, s2) -> sl1.compareToIgnoreCase (s2) 


Na 


The compiler sees the lambda body 
(compare Tol noreCase) has an in 
vesult, and that matthes the return 
type of the compare method on the 
Comparator interface. 


Method arguments ) 


You might be wondering where the return keyword is in the lambda expression. ‘The 
short version is: you don’t need it. The longer version is, if the lambda expression is 

a single line, and if the functional interface’s method signature requires a returned 
value, the compiler just assumes that your one line of code will generate the value 
that is to be returned. 


The lambda expression can also be written like this, if you want to add all the parts a 
lambda expression can have: 


(String s1, String s2) —> { 
return sl1.compareToIgnoreCase(s2) ; 


} 
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Anatomy of a lambda expression 


If you take a closer look at this expanded version of the lambda expression that 
implements Comparator<String>, you'll see it’s not so different from a standard 
Java method. 


If the lambda body is ing; 
Y is inside ¢url 
ja j put semicolons on ea 
e lines, just like lines in a normal Java 


CString s1, String s2) -> method. 
{ 


return sl.compareToIgnoreCase(s2); 


Scr 
} ere 
\ ose K The lambda body, whieh is cher A Te 
\od2 ee aw ew} if line ov multiple lines inside oa e tode 
Lany i OR ve I+ the lambda overrides a the core functionality. This ì wie 
tan VE E Yor ee on method that returns a value, that would make up the bag tis 
att od cee one a i lambda body is inside ethod if this rn M a "M 
5 e ~ cur races, m : menti he tunto . 
“gnats Nenu an a i Sr ee 7 one pain ambda body is the aes 
Wwe Ty yrates: of the lambda body. |f the A the compare) method in Comparator: 


lambda expression is a single 
line, the Compiler can work out 


what needs to be returned. 


The shape of the lambda (its parameters, return type, and what it can reasonably be 
expected to do) is dictated by the Functional Interface it implements. 
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Variety is the spice of life 


Lambda expressions can come in all shapes and sizes, and still conform 
to the same basic rules that we’ve seen. 


A lambda might have more than one line 


A lambda expression is effectively a method, and can have as many 
lines as any other method. Multiline lambda expressions must be in- 
side curly braces. Then, like any other method code, every line must 
end in a semicolon, and if the method is supposed to return something, 
the lambda body must include the word “return” like any normal 


method. \ ents i 
awnie be boring if we 
son . ons Life would e orm 
o pnd TA (strl, str2) -> { Serie all looked the same: 
ere $ : aeS. on beng int 11 = stril.length(); ren 
Compare the collet a as int 12 = str2.length(); C 
ts m z \eng _ : urh b 
yesu amg return 12 Ma fe Y br 
sorte or det } wo ê F multilin hired 
gestendnd “Press 
Return keyword 
require F 


Single-line lambdas don't need ceremony 


If your lambda expression is a single line, it makes it much easier for the compiler to guess 
what’s going on. Therefore, we can leave out a lot of the “boilerplate” syntax. If we shrink 
the lambda expression from the last example into a single line, it looks like this: 


No need for curly braces ent, © 
(strl, str2) Ves -length() - strl.length ONS 


AS 


No semicolons 
No need for “return” 


This is the same Functional Interface (Comparator) and performs the same operation. 
Whether you use multiline lambdas or single-line lambdas is completely up to you. It will 
probably depend upon how complicated the logic in the lambda expression is, and how 
easy you think it is to read—sometimes longer code can be more descriptive. 


Later, we'll see another approach for handling long lambda expressions. 
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A lambda might not return anything 


The Functional Interface’s method might be declared void; i.e., it doesn’t return anything. In these 


cases, the code inside the lambda is simply run, and you don’t need to return any values from the 
lambda body. 


This is the case for lambda expressions in a forEach method. 


) 
\ 
kl No ound brackets! w 
Loo Ik A again in a minute: @FunctionalInterface 
SeS public interface 
Str => 4 Consumer<T> { 
Multiline String output l = "str =" 2 STE; void accept (T t); 
\ambdð ' System.out.printin (output); } 7 


No return value 


is Vo the 
thod is void on 
Patio |nterxace 


A lambda might have zero, one, or many parameters 


The number of parameters the lambda expression needs is dependent upon the number of parameters 
the Functional Interface’s method takes. The parameter types (e.g., the name “String”) are not usually 
required, but you can add them if you think it makes it easier to understand the code. You may need 
to add the types if the compiler can’t automatically work out which Functional Interface your lambda 
implements. 


i£ a lambda expression doesn t 


à 
ameters, You need , 
maa WT prackets to show this. @FunctionalInterface 


public interface Runnable { 


() -> System. out.printlin("Hello!") void ean; 


= } 
No method parameters A i 


No need for round brackets if it’s a single parameter 

without a type (remember param types are optional) 
L @FunctionalInterface 

str -> System.out.printin(str) public interface Consumer<T> { 


RH void accept (T t); 
} 
One method parameter ee 4 


@FunctionalInterface 
public interface Comparator<T> { 
int compare(T ol, T 02); 


} 
L Two method parameters OM 
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(str1, str2) -> strl1.compareToIgnoreCase (str2) 


lambda method parameters 


How can I tell if a method takes a lambda? 


By now you've seen that lambda expressions are implementations of a functional inter- 
face—that is, an Interface with a Single Abstract Method. That means the type of a 
lambda expression is this interface. 


Go ahead and create a lambda expression. Instead of passing this into some method, as 

we have been doing so far, assign it to a variable. You'll see it can be treated just like any 

other Object in Java, because everything in Java is an Object. The variable’s type is the 

Functional Interface. 
Comparator<String> comparator = (s1, s2) -> sl.compareToIgnoreCase(s2) ; 
Runnable runnable = () -> System.out.printin("Hello!"); 
Consumer<String> consumer = str -> System.out.printin(str) ; 

How does this help us see if a method takes a lambda expression? Well, the method’s 


parameter type will be a Functional Interface. Take a look at some examples from the 
Streams API: 


Stream<T> filter(Predicate<? super T> predicate) 
boolean allMatch(Predicate<? super T> predicate) 


Y 


<R> Stream<R> map(Function<? super T,? extends R> mapper) 


nterface 


ionallt 
a@Function face pred 


public inte? 


icate<T> 


@Functionalinterface 
Public interface Function<T R> 


void forEach(Consumer<? super T> action) 
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Exercise BE the Compiler, advanced 
public interface Runnable { 


Your job is to play compiler and determine void run(); 
. which of these statements would compile. } 
he But some of this code wasn’t covered in oP 

} public interface Consumer<T> { 
| the chapter, so you need to work out the void accept (T È); 
| answers based on what you DID | } 
learn, applying the “rules” to 


these new situations. public interface Supplier<T> { 


T get(); 
The signatures of the } 
! functional interfaces are on the 
right, for your convenience. 


public interface Function<T, R> { 
R apply (T t); 
} 


Check the box if the statement would compile. 


Q Runnable r = () -> System.out .printin("Hi!"); 

E Consumer<String> c = s -> System.out.println(s) ; 

Q Supplier<String> s = () -> System.out.printin ("Some string"); 
E Consumer<String> c = (s1, s2) -> System.out.printin(sl + s2); 
E Runnable r = (String str) -> System.out .printin (str); 

E Function<String, Integer> f = s -> s.length(); 


E Supplier<String> s 


() -> "Some string"; 

Q Consumer<String> c = s -> "String" + s; 

Q Function<string, Integer> f = (int i) -> "i = " + i; 
Q Supplier<String> s = s -> "Some string: " + s; 


E Function<String, Integer> f = (String s) -> s.length(); 


—— Answers on page 418. 
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identifying functional interfaces 


Spotting Functional Interfaces 


So far we’ve seen Functional Interfaces that are marked with a @FunctionalInterface annotation 
(we'll cover annotations in Appendix B), which conveniently tells us this interface has a Single Abstract 
Method and can be implemented with a lambda expression. 


Not all functional interfaces are tagged this way, particularly in older code, so it’s useful to understand 
how to spot a functional interface for yourself. 


How hard can it be? I just 
have to look for interfaces 
with only one method! 


Not so fast! 


Originally, the only kind of methods allowed in interfaces were abstract methods, methods 
that need to be overridden by any class that implements this interface. But as of Java 8, interfaces 
can also contain default and static methods. 


You saw static methods in Chapter 10, Numbers Matter, and you'll see them later in this chapter 
too. These are methods that don’t need to belong to an instance, and are often used as helper 
methods. 


Default methods are slightly different. Remember abstract classes from Chapter 8, Serious Poly- 
morphism? ‘They had abstract methods that need to be overridden, and standard methods with 
a body. On an interface, a default method works a bit like a standard method in an abstract 
class—they have a body, and will be inherited by subclasses. 


Both default and static methods have a method body, with defined behavior. With interfaces, 
any method that is not defined as default or static is an abstract method that must be 
overridden. 
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Functional interfaces in the wild 


Now that we know interfaces can have non-abstract methods, we can see there’s a bit more of a trick to 


identifying interfaces with just one abstract method. Take a look at our old friend, Comparator. It has a 
lot of methods! And yet it’s still a SAM-type; it has only one Single Abstract Method. It’s a Functional 
Interface we can implement as a lambda expression. 


Object class. 


ActionListener 
Modifier and Type 


void 


Method 


actionPerformed(ActionEvent e) 


Modifier and Type Method 

int compare(T 0l, T 02) 

static <T,U extends Comparable<? comparing(Function<? super T,? extends U> keyExtractor) 
Super U>> 


Comparator<T> 


static <T,U> 
‘omparator<T> 


comparing(Function<? super T,? extends U> keyExtractor, Compa 
super U> keyComparator) 


static <T> Comparator<T> comparingDouble(ToDoubleFunction<? super T> keyExtractor) 
—— 


static <T> Comparator<T> 
— 


comparingInt(ToIntFunction<? super T> keyExtractor) 


static <T> Comparator<T> comparingLong(ToLongFunction<? super T> keyExtractor) 
—_ 


> boolean equals(Object obj) 


static <T extends Comparable<? 
pe 

super T>> 

Comparator<T> 


naturalOrder() 
static <T> Comparator<T> nullsFirst(Comparator<? super T> comparator) 
—— 

static <T> Comparator<T> 
—_ 


nullsLast(Comparator<? super T> comparator) 


default Comparator<T> reversed() 
— 


Which of these interfaces has a Single Abstract Method and can 
therefore be implemented as a lambda expression? 


BiPredicate 
Modifier and Type Method 


default BiPredicate<T,U> and(BiPredicate<? super T,? super U> other) 


default BiPredicate<T,U> negate() 
default BiPredicate<T,U> or(BiPredicate<? super T,? super U> other) 


boolean test(T t, U u) 


Iterator 
Modifier and Type Method 


default void 
boolean 
E 


default void 
Function 
Modifier and Type Method 
default <V> Function<T,V> andThen(Function<? super R,? extends V> after) 
R apply(T t) 
default <V> Function<V,R> 


static <T> Function<T,T> identity() 


compose(Function<? super V,? extends T> before) 


forEachRemaining(Consumer<? super E> action) 
hasNext () 
next() 


remove() 


SocketOption 
Modifier and Type Method 
String name () 


Class<T> type() 


— Answers on page 419. 
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streams as queries 


Lou's back! 


Lou’s been running his new jukebox management software from the 


Now that I have data about 
what's been played on my 
jukebox, I want to know more! 


last chapter for some time now, and he wants to learn so much more 
about the songs played on the diner’s jukebox. Now that he has the 
data, he wants to slice-and-dice it and put it together in a new shape, 
just as he does with the ingredients of his famous Special Omelette! 


He’s thinking there are all kinds of information he could learn about 4 
the songs that are played, like: i 


e What are the top five most-played songs? 
e What sort of genres are played? 
e Are there any songs with the same name by different artists? 


We could find these things out writing a for loop to look at our song 
data, performing checks using if statements, and perhaps putting 
songs, titles, or artists into different collections to find the answers to 
these questions. 


But now that we know about the Streams API, 
we know there’s an easier way... 


The code on the next page is your mock code; calling Songs . getSongs () will give you a List of Song 
objects that you can assume looks just like the real data from Lou’s jukebox. 


Type in the Ready-Bake Code on the next 
page, including filling out the rest of the 
Song class. When you've done that, create 
a main method that prints out all the songs. 


What do you expect the output to look like? 
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Ready-Bake Here’s an updated “mock” method. It will return some test data that 


we can use on to try out some of the reports Lou wants to create for 


| Cade the jukebox system. There’s also an updated Song class. 


class Songs { 


public List<Song> getSongs() { 


return List.of( 


new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 
new 


new 


} 


Song("$10", "Hitchhiker", "Electronic", 2016, 183), 

Song("Havana", "Camila Cabello", "R&B", 2017, 324), 

Song("Cassidy", "Grateful Dead", "Rock", 1972, 123), 

Song("50 ways", "Paul Simon", "Soft Rock", 1975, 199), 

Song("Hurt", "Nine Inch Nails", "Industrial Rock", 1995, 257), 
Song("Silence", "Delerium", "Electronic", 1999, 134), 

Song("Hurt", "Johnny Cash", "Soft Rock", 2002, 392), 

Song("Watercolour", "Pendulum", "Electronic", 2010, 155), 

Song("The Outsider", "A Perfect Circle", "Alternative Rock", 2004, 312), 
Song("With a Little Help from My Friends", "The Beatles", "Rock", 1967, 168), 
Song("Come Together", "The Beatles", "Blues rock", 1968, 173), 

Song("Come Together", "Ike & Tina Turner", "Rock", 1970, 165), 

Song("With a Little Help from My Friends", "Joe Cocker", "Rock", 1968, 46), 
Song ("Immigrant Song", "Karen O", "Industrial Rock", 2011, 12), 
Song("Breathe", "The Prodigy", "Electronic", 1996, 337), 

Song("What's Going On", "Gaye", "R&B", 1971, 420), 

Song ("Hallucinate", "Dua Lipa", "Pop", 2020, 75), 

Song("Walk Me Home", "P!nk", "Pop", 2019, 459), 

Song("I am not a woman, I'm a god", "Halsey", "Alternative Rock", 2021, 384), 
Song ("Pasos de cero", "Pablo Alborán", "Latin", 2014, 117), 

Song("Smooth", "Santana", "Latin", 1999, 244), 

Song("Immigrant song", "Led Zeppelin", "Rock", 1970, 484)); 


public class Song { 


private final String title; 


private final String artist; 


private final String genre; 


private final int year; 


private final int timesPlayed; 


// Practice for you! Create a constructor, all the getters and a toString() 
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filtering streams 


Lou’s Challenge #1: Find all the “rock” songs 


The data in the updated song list contains the genre of the song. Lou’s noticed that the 


diner’s clientele seem to prefer variations on rock music, and he wants to see a list of all 
the songs that fall under some genre of “rock.” 


This is the Streams chapter, so clearly the solution is going to involve the Streams API. 
Remember, there are three types of pieces we can put together to form a solution. 


oo ional! 
collection —> . stream () This one’s not really optional: 
Wen 
API ag look 
that pee HE thee Streg 


Lou Said h 
e Wan aL 
C t mateh what of a the Sonas 
collect the a ese eaa 


Fortunately, there are hints about how to create a Streams API call based on the require- 


ments Lou gave us: he wants to filter for just the Songs with a particular genre, and he 
wants to collect them into a new List. 


java.util.stream.Stream 


<? super T> predicate) 


er(Predicate the given 

stream<T> sea f the elements that match the g t for now 

Returns a stream O Remember tha ‘a no i" 

t . = se e 
dicate. we're just going To u 
i T,A,R> collector) ie aata to collect 
tor<? super iad his è 
<R,A>R collect(Collectors: on on the elements oft into a List. 
L 


stream using a Collector. 
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Filter a stream to keep certain elements 


Let’s see how a filter operation might work on the list of songs. 


These squares wran i the 

la 
re - h d erent po 
pee a loer genre: 


ANN, 
id ml . stream () 
Nadie to get a stream from hitlret N Ta Turns Our eo 
t i T ream 


Y tode, this would be 
operan ee n expression 
Te Fe Ee oe ert mE = that says which Eye 
iet e oun i a oA of elements to keep: 
we 
tare 


Output the results as a List. — > ¡collect (toList) 7 A 
The 
strega Put of hi 
Py Li Pipeline i s 


ToS thag Just 
He eat 
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filtering streams 


Let’s Rock! 


So adding a filter operation filters out elements that we don’t want, and the stream 
continues with just the elements that meet our criteria. It should come as no surprise to find 
that you can use a lambda expression to state which elements we want to keep in the stream. 


The filter method takes a Predicate. 


chunctionalinterface 

li ; 

P as interface Predicate<T> { 
oolean test (T t); 
poole" 


Has a si 

Given what we know about the shapes of a single Parameter 
lambda expressions, we should be able to 
work out how to write a lambda expression 
that implements Predicate. \ 

s a single 

Take: ane Must vesult ip a bool 
param true/fals e) ĉan value 
Predicate predicate = -> | | 


We’ll know what the type of the single parameter is when we plug it into the Stream opera- 
tion, since the input type to the lambda will be determined by the types in the stream. 


public class JukeboxStreams { 
public static void main(String[] args) { 


List<Song> songs = new Songs ().getSongs () d a betavse Get the Genre G Shi j 
This is a List of Sonas This we a atking on a ng and see if tt ip from the 
9s. T ok Song return a true oe false his 


List<Song> rockSongs = songs.stream() 


; .filter (song -> song.getGenre () .equals ("Rock") ) 
seline Ong -> ERPI ISEE TERSA RSE 


The stream Y i .collect (Collectors .toList ()); ! ts 
vill return 3 Se non TT mn A This lambda implemen 


ok Sent Puts the results into a List. Predicate: 


System.out.printin(rockSongs) ; 


File t Window Help StonefaceVimes 


class Songs { %java JukeboxStreams 
// as Ready-Bake Code 
} [Cassidy, Grateful Dead, Rock 
class Song { With a Little Help from My Friends, The Beatles, Rock, 
// as Ready-Bake Code Come Together, Ike & Tina Turner, Rock, 
} With a Little Help from My Friends, Joe Cocker, Rock, 


Immigrant song, Led Zeppelin, Rock] 
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Getting clever with filters 


The filter method, with its “simple” true or false return value, can contain 
sophisticated logic to filter elements in, or out, of the stream. Let’s take our filter one 
step further and actually do what Lou asked: 


He wants to see a list of all the songs that fall under some genre of “rock.” 
He doesn’t want to see just the songs that are classed as “Rock,” but any genre that 


is kinda Rock-like. We should search for any genre that has the word “Rock” in it 
somewhere. 


There’s a method in String that can help us with this, it’s called contains. 


Returns true if the genre 
has the word “Rock in it 


re 
List<Song> rockSongs = songs.stream() anywhe 


.filter (song -> song.getGenre() .contains ("Rock") ) 
—— 
.collect (Collectors .toList ()); 


% java JukeboxStreams 


[Cassidy, Grateful Dead, Rock turns different 
50 ways, Paul Simon, Soft Rock Now the stream re 

Hurt, Nine Inch Nails, Industrial Rock types i 

Hurt, Johnny Cash, Soft Rock 


Output chop 


in the bo Ped down to save space 


ok—save the trees/ 


=) 
Brain Barbell 


Can you write a filter operation that can select 
songs: 


e By The Beatles 
e That start with “H” 


e More recent than 1995 
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Lou's Challenge #2: List all the genres 


Lou now senses that the genres of music that the diners are listening to are more 
complicated than he thought. He wants a list of all the genres of the songs that have 
been played. 


So far, all of our streams have returned the same types that they started with. The 
earlier examples were Streams of Strings, and returned Lists of Strings. Lou’s previous 
challenge started with a List of Songs and ended up with a (smaller) List of Songs. 


Lou now wants a list of genres, which means we need to somehow turn the song 
elements in the stream into genre (String) elements. This is what map is for. The map 
operation states how to map from one type to another type. 


. stream () 


annar 
the ee 


m ts 
o eae Ae list of songs \ ml 
ketoni? a stream o songs- 


a 
A ma ți À You need to give the m 
the rete i. -map([|—>Q) ) operation a lambda aes 
are of one type into iis peices of how to 
nother. Here, we will want E) on, eré Trom one type to 


to turn songs into genres. another. 


After the maf operation et @ @ The output of this 


A\ contain ie oa List 
the stream, “E, + tyre @ am pipeline is 3 
elemen of a Aae are ie genres- 
Lh e Lyre we mapy 


.collect (toList) 


OD @O® 
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Mapping from one type to another 


The map method takes a Function. The generics by definition are a bit vague, which 
makes it a little tricky to understand, but Functions do one thing: they take something of 
one type and return something of a different type. Exactly what’s needed for mapping 


varies from one type to another. 


@Functionalinterface 
Public interface Fu. 
R apply (T t); 


nction<T, R> { 


jett 


Returns some 


Takes a single Parameter 


Let’s see what it looks like when we use map in a stream pipeline. 


: List of ie eter 
\b will be a" 3 's a List of \e 8 s 
he resu! eis singe dn 
pan because gent Song objects. ote ta ae eam 
String f we y 
List<String> genres = songs.stream() K Cont 


.map (song -> song.getGenre() ) 


.collect (toList ()); Th | 
y II e lamb, 
Puts the results into a List P The lambda ty Can return an 
delen ype. By Callin 
4 € on th Son t 9 
ream after this 9 the 


a stream of (genre p oo 4 


The map’s lambda expression is similar to the one for filter; it takes a song and turns it 
into something else. Instead of returning a boolean, it returns some other object, in this 


case a String containing the song’s genre. 


File Edit Window Help RoadToNowhere 


% java JukeboxStreams 


[Electronic, R&B, Rock, Soft Rock, Industri- 
al Rock, Electronic, Soft Rock, Electronic, 


Alternative Rock, Rock, Blues rock, Rock, 
Rock, Industrial Rock, Electronic, R&B, Pop, 
Pop, Alternative Rock, Latin, Latin, Rock] 


you are here » 
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unique elements 


Removing duplicates 


We've got a list of all the genres in our test data, but Lou probably doesn’t want to wade 
through all these duplicate genres. The map operation on its own will result in an out- 
put List that’s the same size as the input List. Since stream operations are designed to be 
stacked together, perhaps there’s another operation we can use to get just one of every 
element in the stream? 


@® 
— Ø Da 
astinet operation m This intermediate ati 
Te gry duplicate elements . distinct () doesn't take any ci e te it’s 
getting through just à command on iks oun 


Only One f 
make it through pCt wil 


of the Pipeline. the end @ The output of this stream 


@ ipeline is a vew Last 
i 


: S; 
e unique genre 


O@D @ 


.collect (toList) 
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Only one of every genre 


All we need to do is to add a distinct operation to the stream pipeline, and we'll get 
just one of each genre. 
List<String> genres = songs.stream() 
.map (song -> song.getGenre() ) 


II .distinct () 
.collect (Collectors .toList ()); 


Having this in the stream 

pipeline means there will be no 

duplicates after this point 
%java JukeboxStreams 


Outputs a much more [Electronic, R&B, Rock, Soft Rock, 
readable list of all the genres GERERE Rock, Alternative Rock, 
Blues rock, Pop, Latin] 


Just keep building! 


A stream pipeline can have any number of intermediate operations. The power 

of the Streams API is that we can build up complex queries with understandable 
building blocks. The library will take care of running this in a way that is as efficient 
as possible. For example, we could create a query that returns a list of all the artists 
that have covered a specific song, excluding the original artists, by using a map 
operation and multiple filters. 


String songTitle = "With a Little Help from My Friends"; 

List<String> result = allSongs.stream() 
.filter (song -> song.getTitle() .equals (songTitle) ) 
.map (song -> song.getArtist () ) 
.filter(artist -> !artist.equals ("The Beatles") ) 
.collect (Collectors.toList ()); 


@qaharpen your pencil 
aN 
Try annotating this code yourself. 
What do each of the filters do? 
What does the map do? 


—-» Yours to solve. 
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method references 


Sometimes you dont even need a lambda expression 


Some lambda expressions do something simple and predictable, given 
the type of the parameter or the shape of the functional interface. Method references 
Look again at the lambda expression for the map operation. can replace lambda 


Function<Song, String> getGenre = song -> song.getGenre() ; expressions, but you 
? 
Instead of spelling this whole thing out, you can point the compiler don’t have to use them. 


to a method that does the operation we want, using a method S ° 
ometimes method 


reference. 
À F nection oc output of getGenre() isa references make 
The output of this u ring, just like the Function d e 
“cede to be a String: needs: the code easier to 
understand. 
Function<Song, String> getGenre = Song: :getGenre; This is th in 
= aall in the lambda beg 
The i wmstead £ usini 
se aT to this method veferente— FA compiler A 


w that would cause COR point the 


a n 
method, use 3 method. 
kya š the divettion of the metho 
om 


Method references can replace lambda expressions in a number of different cases. Generally, we might 
use a method reference if it makes the code easier to read. 


Take our old friend the Comparator, for example. There are a lot of helper methods on the 
Comparator interface that, when combined with a method reference, let you see which value is being 
used for sorting and in which direction. Instead of doing this, to order the songs from oldest to newest: 


List<Song> result = allSongs.stream() 
.sorted((o1l, 02) -> ol.getYear() - o2.getYear() ) 
.collect (toList()); 


Use a method reference combined with a static helper method from Comparator to state what the 
comparison should be: 


List<Song> result = allSongs.stream() 
. sorted (Comparator .comparingInt (Song: :getYear) ) 
-collect (toList()); 


; Relax You don’t need to use method references 
if you don’t feel comfortable with them. 

| What’s important is to be able to 
recognize the “::” syntax, especially in a 


stream pipeline. 
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Collecting results in different ways 


While Collectors .toList is the most commonly used Collector, there are other useful Collectors. 
For example, instead of using distinct to solve the last challenge, we could collect the results into a 
Set, which does not allow duplicates. The advantage of using this approach is that anything else that uses 
the results knows that because it’s a Set, by definition there will be no duplicates. 


Set<String> genres = songs.stream() 


.map (song -> song.getGenre() ) Put the v esults into i a? 
Store the results in a Set . collect (Collectors .toSet ()) ; which will aia y 
of Strings, not a List. Sets A nave mige e ii 


tannot Contain duplicates. 


Collectors.toList and 
Collectors.toUnmodifiableList 


You’ve already seen toList. Alternatively, you can get a List that can’t ad 
be changed (no elements can be added, replaced or removed) by using 

Collectors .toUnmodifableList instead. This is only available from List 

Java 10 onward. 


Collectors.toSet and 
Collectors.toUnmodifiableSet NO duplicates. 


Use these to put the results into a Set, rather than a List. Remember that a Set 
cannot contain duplicates, and is not usually ordered. If you’re using Java 10 
or higher, you can use Collectors. toUnmodifiableSet if you want to 
make sure your results aren’t changed by anything, 


Collectors.toMap and 
Collectors.toUnmodifiableMap 


You can collect your stream into a Map of key/value pairs. You will need to 
provide some functions to tell the collector what will be the key and what will 
be the value. You can use Collectors. toUnmodifiableMap to create a 
map that can’t be changed, from Java 10 onward. 


Collectors.joining 


You can create a String result from the stream. It will join together all the 
stream elements into a single String. You can optionally define the delimiter, the 
character to use to separate each element. This can be very useful if you want 
to turn your stream into a String of Comma Separated Values (CSV). 
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terminal operations 


But wait, there's more! 


Collecting the results is not the only game in town; collect is just one of many terminal operations. 


Checking if something exists 


You can use terminal operations that return a boolean value to look for certain things in the stream. For 
example, we can see if any R&B songs have been played in the diner. 


boolean result = 
songs.stream() 
.anyMatch (s -> s.getGenre() .equals ("R&B") ) ; boolean allMatch (Predicate p); 


boolean anyMatch (Predicate p); 


boolean noneMatch (Predicate p); 


Find a specific thing 


Terminal operations that return an Optional value look for certain things in the stream. For example, 
we can find the first song played that was released in 1995. 


Optional<Song> result = Optional<T> findAny () ; 
songs.stream() : , 
filter(s -> s.getYear() == 1995) Optional<T> findFirst () ; 


-findFirst(); Optional<T> max (Comparator c); 


Optional<T> min (Comparator c); 


Optional<T> reduce (BinaryOperator a); 


Count the items 


There’s a count operation that you can use to find out the number of elements in your stream. We could 
find the number of unique artists, for example. 


long result = 
songs.stream() long count (); | 


.map (Song: :getArtist) 
.distinct () 


sommes There are even more terminal operations, 
and some of them depend upon the type of 
Stream you're working with. 


Remember, the API documentation can 
help you figure out if there’s a built-in 
operation that does what you want. 
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Wait a minute. How cana 
result be “Optional”? What does 
that even mean? 


Well, some operations may return something, or may not return 
anything at all 

It might seem weird that a method may or may not return a value, but it 

happens all the time in real life. 


Imagine you’re at an ice-cream stand, and you ask for strawberry ice 
cream. 


Strawberry ice 


cream, please! 


Here you go! IceCream iceCream = 
getIceCream ("Strawberry"); 


Easy, right? But what if they don’t have any strawberry? The ice-cream 
person is likely to tell you “we don’t have that flavor.” 


We don't have 


any, sorry. 


It’s then up to you what you do next—perhaps order chocolate instead, 
find another ice-cream place, or maybe just go home and sulk about your 
lack of ice cream. 


Imagine trying to do this in the Java world. In the first example, you get 
an ice-cream instance. In the second, you get...a String message? But a 

message doesn’t fit into an ice-cream-shaped variable. A null? But what 
does null really mean? 


youarehered> 411 


optional 


Optional is a wrapper 


Since Java 8, the normal way for a method to declare that sometimes it might not return a 
result is to return an Optional. This is an object that wraps the result, so you can ask “Did 
I get a result? Or is it empty?” Then you can make a decision about what to do next. 


Strawberry ice 


cream, please! 
Herevouaol Optional<IceCream> optional = 
D you go: getIceCream ("Strawberry"); 
D (0) 


Do you have if (optional.isPresent()) { 
something 
inside? 
D 
ra) 
Great! Give it to 
me! Please. 
D IceCream ice = optional.get(); 
} 
ra) 
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You've just introduced two 
new steps for me to get my 
ice cream! 


Yes, but now we have a way to ask if we have a result 


Optional gives us a way to find out about, and deal with, the times 
when you don’t get an ice cream. 


Optional<IceCream> optional = 
getIceCream ("Strawberry"); 


Strawberry ice 
cream, please! 


D Here you go! 
2 (0) 
v 
Do you have if (optional.isPresent()) { 
something 
inside? 
D 
oO 
0 
Uv 
OK, never mind, 
thanks. } else { 
D System.out .printin ("No ice 
D cream for you!"); 


} 


In the past, methods might have thrown Exceptions for this case, or 
return “null”, or a special type of “Not Found” ice-cream instance. Re- 
turning an Optional from a method makes it really clear that anything 
calling the method needs to check if there’s a result first, and then 
make their own decision about what to do if there isn’t one. 
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optional 
Don't forget to talk to the Optional wrapper 


The important thing about Optional results is that they can be empty. If you don’t 
check first to see if there’s a value present and the result is empty, you will get an 
exception. 


Strawberry ice 


Optional<IceCream> optional = 


cream, please! 
getIceCream ("Strawberry"); 


Here you go! 


IceCream ice = optional.get(); 


File Edit Window Help Boom 


%$ java OptionalExamples 


Exception in thread "main" Jjava.util.No- 
SuchElementException: No value present 
at java.base/java.util.Optional. 
get (Optional. java:148) 
at chl10c.OptionalExamples. 


main (OptionalExamples. java:11) 
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lambdas and streams 


2 The Unexpected Coffee 
-= Alex was programming her mega-ultra-clever (Java-powered) coffee machine to give her the 
types of coffee that suited her best at different times of day. 


Five-Minute In the afternoons, Alex wanted the machine to give her the weakest coffee it had available (she 
had enough to keep her up at night; she didn’t need caffeine adding to her problems!). As an 


Myster Y experienced software developer, she knew the Streams API would give her the best stream of 
coffee at the right time. 


The coffees would automatically be sorted from the weakest to the strongest using 
natural ordering, so she gave the coffee machine these instructions: 


Optional<String> afternoonCoffee = coffees.stream() 
-map (Coffee: :getName) 


.-sorted() 


.findFirst(); 


The very next day, she asked for an afternoon coffee. To her horror, the machine presented her 
with an Americano, not the Decaf Cappuccino she was expecting. 


“I can’t drink that!! PI be up all night worrying about my latest software project!” 


What happened? Why did the coffee machine give Alex an Americano? 


————> Answers on page 419. 
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puzzle: Pool Puzzle 


RR Poo] Puzzle 


ea 


Your job is to take code snippets from 
the pool and place them into the blank 
lines in the code. You may not use the 
same snippet more than once, and 
you won't need to use all the snip- 
pets. Your goal is to make a class that 
will compile and run and produce the 
output listed. 


Output 


S$java StreamPuzzle 
[Immigrant Song, With a Little 


Help from My Friends, Hallucinate, 
Pasos de cero, Cassidy] 


With a Little Help from My Friends 
No songs found by: The Beach Boys 


Note: each thing from 


the pool can be used 
only once! 


result.get().getTitle() 
printTopFiveSongs() 


songSearch.search("The Beach Boys") 


"No songs found by: " + artist 
songSearch 


limit(5) 
Collectors.toList() 


new SongSearch() 
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findFirst() 


SongSearch 


sorted(Comparator.comparingInt(Song::getTimesPlayed)) N 


filter(song -> song.getArtist().equals(artist 


public class StreamPuzzle { 


public static void main(String[] 
SongSearch songSearch = 
songSearch. 


args) 


_—SSaa 
.search ("The Beatles"); 


r 


} 
class = 
private final List<Song> songs = 
new JukeboxData.Songs() .getSongs ();}; 


void printTopFiveSongs() { 


List<String> topFive = songs.stream() 


-collect ( ; 


System.out.printin(topFive) ; 
} 
void search(String artist) { 
= songs.stream() 


if ( ) { 


System. out.println ( 
} else { 
System.out.println ( 


result.isPresent() 


Optional<Song> result 


map(song -> song.getTitle()) 


————> Answers on page 420. 


{ 


ee 


lambdas and streams 


Mixed Messages 


(from page 372) 
Candidates: Possible output: 
for (int 2 = 17 i =< nums.size()i; i++) 
output += nums.get(i) +" "; 23 45 


for (Integer num : nums) 


ou 


for (int i = 0; i <= nums.length; i++) 


tpu 


Compiler error 


E a= inline: ap H Wy 


2 345 


Exception thrown 


Ghee c= inns E a Ws 
TES — , [i 2, 3, 47 Əl 
for (int i aN i <= EE 7 i++) i, 2, 3, å, 5] 
output += nums.get (i) + 9 
[1, 2, 3, 4, 5] 
[1, 2 r 3 7, Gp 3 
IL, 2 r 3 p a 5| 
WHA aS ar? 
= (from page 374) 
Po Changes the current element in the 
filter ; 
stream into something else 
P Sets the maximum number of elements 
skip 
that can be output from this Stream 
limit While a given criteria is true, will not 
process elements 
distinct Only allows elements that match the 
given criteria to remain in the Stream 
sorted Will only process elements while the 
given criteria is true 
States the result of the stream should 
map 
be ordered in some way 
o This is the number of elements at the start 
Iropwhile l 
mp of the Stream that will not be processed 
takeWhile Use this to make sure duplicates are 


removed 
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exercise solutions 


Code Magnets (from page 386) 


What would happen if the 
stream operations were in 


import java.util.*; a different order? Does it 
import java.util.stream.*; matter? 


public class CoffeeOrder { 
public static void main(String[] args) { 

List<String> coffees = List.of ("Cappuccino", 
"Americano", "Espresso", "Cortado", "Mocha", 
"Cappuccino", "Flat White", "Latte"); [Americano, Cappuccino, 

Cortado, Espresso] 


%java CoffeeOrder 


List<String> coffeesEndingInO = coffees.stream() 
-filter(s -> s.endsWith("o") ) 
. sorted () 
-distinct () 
-collect (Collectors.toList()); 


System.out.printin(coffeesEndingIn0O) ; 
} 
} 


BE the Compiler (from page 395) 


Runnable r = () -> System.out.println("Hi!"); 


? 
goes 


x p Sorina, O“ 
Consumer<String> c = s -> System.out.printin (s); chould eure 


Q Supplier<String> s 


() -> System.out .printin ("Some string"); 


g Should take only one 
Consumer<String> c = (sl, s2) -> System.out.println(s1 + s2); parameter but has two 


Q Runnable r = (String str) -> System.out.printin (str) ;` Should ati 
ve Parameters 
Function<String, Integer> f = s -> s.length(); ' cos 
is sinale-line lambda effectively returns a Str 
as ne ans ere should return nothing, Even 
theesh there's no “return, this ae String, 
Í- ones Ey value is assumed to be the returned value- 


Y supp1ier<string s () -> "Some string"; 


Q Consumer<String> c 


5 Should have a String parameter and 
Function<String, Integer> f = (int i) -> "i = "_+ i; return an int, but instead it has an 


int Param and returns a String 
E Supplier<String> s = s -> "Some string: " + s; 


Should not have any parameters 
Q Function<String, Integer> f = () -> System.out.printin("Some string"); 


A 
Should take a String parameter. Should return an int, but attually returns nothing. 
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ogee your pencil  modiner and Type Method 


lambdas and streams 


BiPredicate 


Lod 
strat MA jekavtt 


default BiPredicate<T,U> and(BiPredicate<? super/T,? super U> other) Siw \e 
(from page 397) Was 3 The others 3 
default BiPredicate<T,U> negate() best: 
Ss: 
default BiPredicate<T,U> or(BiPredicate<? super T,? super U> oe mer nod 
boolean test(T t, U u) 
ActionListener 


ma N e i bstract Method 
void a es Has a Single A 


Iterator 


Modifier and Type Method 


Has TWO default void forEachRemaini ? i 
abs r efault voi 'orEachRemaining(ConsuNgf<? super E> action) 
hasN, t act methods boolean hasNext 
ex and next() ) — >» ) 
“~~ E next() 
default void remove() 
Function 
Modifier and Type Method H 
default <V> Function<T,V> andThen(Function<? super R,?7/extends V> after) "i a Abstract Method, 
a 5 
R apply(T t) æ PRY The others are default 


default <V> Function<V,R> compose(Function<? 


and static methods. 


per V,? extends T> before) 


static <T> Function<T,T> identity() 


SocketOption 
Modifier and Method 


Has two abstract methods string aai 


Class<T> thee() 


Five-Minute Mystery (from page 415) 


coffee objects to a stream of Strings, and then ordered that. Strings are naturally ordered 


VA Alex didn’t pay attention to the order of the stream operations. She first mapped the 


alphabetically, so when the coffee machine got the “first” of these results for Alex’s 
afternoon coffee, it was brewing a fresh “Americano.” 


If Alex wanted to order the coffees by strength, with the weakest (1 out of 5) first, she 
needed to order the stream of coffees first, before mapping it to a String name, 
afternoonCoffee = coffees.stream() 


.sorted() 


-map (Coffee: : getName) 
-findFirst(); 


Then the coffee machine will brew her a decaf instead of an Americano. 
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puzzle solutions lambdas and streams 


Pos] Puzzle (from page 416) 


public class StreamPuzzle { 


public static void main(String[] args) { 
SongSearch songSearch = new SongSearch(); 
songSearch. printTopFiveSongs(); 
songSearch.search ("The Beatles"); 
songSearch.search("The Beach Boys"); 


} 
class SongSearch { 
private final List<Song> songs = 
new JukeboxData.Songs() .getSongs (); 


void printTopFiveSongs() { 
List<String> topFive = songs.stream() 
. sorted(Comparator.comparingInt(Song::getTimesPlayed)) 
.map(song -> song.getTitle()) 
. limit(5) 
. collect (Collectors.toList()) ; 
System.out.printin(topFive) ; 
} 


void search(String artist) { 
Optional<Song> result = songs.stream() 
. filter(song -> song.getArtist().equals(artist)) 
. findFirst(); 
if (result.isPresent()) { 
System. out .print1n (result.get().getTitle()) ; 
} else { 
System. out.print1n ("No songs found by:" + artist) ; 
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13 exception handling 


Risky Behavior 


Sure, it's risky, but 
I can handle it if 
something goes wrong. 


Stuff happens. The file isn’t there. The server is down. No matter how 
good a programmer you are, you can’t control everything. Things can go wrong. Very wrong. 
When you write a risky method, you need code to handle the bad things that might happen. 
But how do you know when a method is risky? And where do you put the code to handle the 
exceptional situation? So far in this book, we haven't really taken any risks. We've certainly had 
things go wrong at runtime, but the problems were mostly flaws in our own code. Bugs. And 
those we should fix at development time. No, the problem-handling code we're talking about 
here is for code that you can’t guarantee will work at runtime. Code that expects the file to be 

in the right directory, the server to be running, or the Thread to stay asleep. And we have to do 
this now. Because in this chapter, we're going to build something that uses the risky JavaSound 


API. We're going to build a MIDI Music Player. 


this is a new chapter 421 


building the MIDI Music Player 


Let’s make a Musie Machine 


Over the next three chapters, we’ll build a few different sound ap- 
plications, including a BeatBox Drum Machine. In fact, before 
the book is done, we'll have a multiplayer version so you can 
send your drum loops to another player, kind of like sharing 
over social media. You’re going to write the whole thing, al- 
though you can choose to use Ready-Bake Code for the GUI 
parts. OK, so not every IT department is looking for a new 
BeatBox server, but we’re doing this to learn more about Java. 
Building a BeatBox is just a way to have fun while we’re learning 


Java. 


The finished BeatBox looks something like this: 


You make a beatbox loo 
P (a 16_beat drum 
Putting cheek marks in the n u pattern) by 


eee Cyber BeatBox 


aie Your message 
| Closed Hi-Hat 
p 
| Open Hi-Hat gets sent to 


Tempo:lp the other 


players, along 


| Acoustic Snare 


| Crash Cymbal Tempo Down 


| Hand Clap sendit with your 
| High Tom current beat 
| Hi Bongo dance beat tten 
| Maracas pAn 
| Whistle when you hit 
| » 
| Low Conga “sendlt. 
| Cowbell ; 
ke River: groove #2 
| Vibraslap 
| Low-mid Tom Brooklyn: groove2 revised 
[iighAgogo BoomTish: dance beat 
Open Hi Conga 
: $ (23 » Ineoming m 
Notice the check marks in the boxes for each of the 16 “beats.” For example, on essages from 


beat 1 (of 16) the Bass drum and the Maracas will play, on beat 2 nothing, and on Players. Cliek one to | 
beat 3 the Maracas and Closed Hi-Hat...you get the idea. When you hit Start, it oe Patter, that ae 
plays your pattern in a loop until you hit Stop. At any time, you can “capture” one it, and then liek 

of your own patterns by sending it to the BeatBox server (which means any other play it. Start to 
players can listen to it). You can also load any of the incoming patterns by clicking 

on the message that goes with it. 
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We'll start with the basics 


Obviously we’ve got a few things to learn before the whole program 
is finished, including how to build a GUI, how to connect to another 
machine via networking, and a little I/O so we can send something to 
the other machine. 


Oh yeah, and the JavaSound API. Thats where we'll start in this 
chapter. For now, you can forget the GUI, forget the networking and 
the I/O, and focus only on getting some MIDI-generated sound to 
come out of your computer. And don’t worry if you don’t know 

a thing about MIDI or a thing about reading or making music. 


MIDI file 


Everything you need to learn is covered here. You can almost smell 
the record deal. 


hit it 
The JavaSound API 


JavaSound is a collection of classes and interfaces added to Java 
way back in version 1.3. These aren’t special add-ons; they’re part 
of the standard Java SE class library. JavaSound is split into two 

parts: MIDI and Sampled. We use only MIDI in this book. MIDI 

stands for Musical Instrument Digital Interface, and is a standard 
protocol for getting different kinds of electronic sound equipment 
to communicate. But for our BeatBox app, you can think of 
MIDI as a kind of sheet music that you feed into some device 
like a high-tech “player piano.” In other words, MIDI data 
doesn’t actually include any sound, but it does include the 
instructions that a MIDI-reading instrument can play back. 
Or for another analogy, you can think of a MIDI file like an 
HTML document, and the instrument that renders the MIDI 

file (i.e., plays it) is like the web browser. | 


MIDI data says what to do (play middle C, and here’s how hard to hit 
it, and here’s how long to hold it, etc.), but it doesn’t say anything at 
all about the actual sound you hear. MIDI doesn’t know how to make 
a flute, piano, or Jimi Hendrix guitar sound. For the actual sound, we 
need an instrument (a MIDI device) that can read and play a MIDI 
file. But the device is usually more like an entire band or orchestra of 
instruments. And that instrument might be a physical device, like a 
keyboard, or it could even be an instrument built entirely in software, 
living in your computer. 


For our BeatBox, we use only the built-in, software-only instrument 
that you get with Java. It’s called a synthesizer (some folks refer to it as 
a software synth) because it creates sound. Sound that you hear. 


play high CG 


and hold it 


exception handling 


Formation 
Cie has M 
abou vt doesn 
Lit 
be layed» \ sound gata 
wave YT sheet mS 


MIDI device knows how to “read” 
a MIDI file and play back the 
sound. The device might bea 
synthesizer keyboard or some 
other kind of instrument. 
Usually, a MIDI instrument can 
play a LOT of different sounds 
(piano, drums, violin, ete.), and all 
at the same time. So a MIDI file 
isn’t like sheet musi¢ for just one 
musician in the band—it ĉan hold 
the parts for ALL the musi¢ians 
playing a particular song, 
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but it looked so simple 


First we need a Sequencer 


Before we can get any sound to play, we need a Sequencer object. The sequencer is the 
object that takes all the MIDI data and sends it to the right instruments. It’s the thing 

that plays the music. A sequencer can do a lot of different things, but in this book, we’re 
using it strictly as a playback device. It’s like a device that streams music, but with a few 


added features. The Sequencer class is in the javax.sound.midi package. So let’s start by 
making sure we can make (or get) a Sequencer object. 


d.mid package We need a Sequencer object: It's 


import javax.sound.midi.*; tre jvaxsoun ‘ es : n P 
— the main p l ee 
instrument we re using: It’s An 
tes a e 
public class MusicTest1 { thing that, well, eae oa 
Mare MIDI information n A 
ee But we don't make a brand n D 
we have to ask the 
Sequencer sequencer = MidiSystem.getSequencer () ; one ourselves aor 


ae ive us one- 
System. out .printi1n ("Successfully got a sequencer"); MidiSystem to 9 


public static void main(String[] args) { 
MusicTest1 mt = new MusicTest1(); 
mt .play (); 


Somethings wrong! 
} This code won't compile! The Compi 


’ ler says there’s an 
unreported exception” that must 


be caught or declared. 

[File Edt Window Help Saywa —  — ————— l 
javac MusicTestl. java 

MusicTest1.java:13: unreported exception javax.sound.midi. 

MidiUnavailableException; must be caught or declared to be 


thrown 


Sequencer sequencer = 


MidiSystem.getSequencer() ; 


A 


1 errors 
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exception handling 


What happens when a method you want to call 
(probably in a class you didnt write) is risky? 


Write KO uses Methods T 
n 


@ Let’s say you want 
to call a method ina 
class that you didn’t 
write. 


your code class you 
didn't write 


@ That method does 
something risky, 
something that might 
not work at runtime. class you } 

didn't write } 


void moo() { 
if (serverDown) { 
explode () ; 


I wonder if 
that method 
could blow up... 


© You need to know 
that the method 
you’re calling is 
risky. 


My moo() 
method will 
explode if the 
server is down. 


Now that I 
know, I can take 
precautions. 


class you 
didn't write 


@ You then write code 
that can handle the 
failure if it does 
happen. You need to be 
prepared, just in case. 

your code 
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when things might go wrong 


Methods in Java use exceptions to tell the calling code, 
“Something Bad Happened. | failed.” 


Java’s exception-handling mechanism is a clean, well-lighted way to handle “exceptional 
situations” that pop up at runtime; it lets you put all your error-handling code in one easy-to- 
read place. It’s based on the method you're calling telling you it’s risky (i.e., that the method might 
generate an exception), so that you can write code to deal with that possibility. If you know you 
might get an exception when you call a particular method, you can be prepared for—possibly even 
recover from—the problem that caused the exception. 


So, how does a method tell you it might throw an exception? You find a throws clause in the 
risky method’s declaration. 


The getSequencer() method takes a risk. It can fail at runtime. 
So it must “declare” the risk you take when you call it. 


The API does tell You 


that getSequenter() 
getSequencer 
ĉan throw an exception: 
public static Sequencer getSequencer() idi 2 N 
! 
throws MidiUnavailableException A d UnavailableException. 
me 
Obtains the default Sequencer, connected to a default device. The returned Sequencer instance is connected to the thod has to dee lave 
default Synthesizer, as returned by getSynthesizer(). If there is no Synthesizer available, or the default the exceptions it might 
Synthesizer cannot be opened, the sequencer is connected to the default Receiver, as returned by getReceiver(). + 
The connection is made by retrieving a Transmitter instance from the Sequencer and setting its Receiver. Closing hrow. 


and re-opening the sequencer will restore the connection to the default device. 
This method is equivalent to calling getSequencer (true). 


If the system property javax.sound.midi.Sequencer is defined or it is defined in the file "sound.properties", it is 
used to identify the default sequencer. For details, refer to the class description. 


Returns: 
the default sequencer, connected to a default Receiver 


Throws: 
MidiUnavailableException - if the sequencer is not available due to resource restrictions, or there is no Receiver 
available by any installed MidiDevice, or no sequencer is installed in the system 


See Also: 
getSequencar(boolean), getSynthesizer(), getReceiver() 


This part tells you WHEN you might get that Risky methods that could fail ad 

exception—in this Case, because of resource . runtime declare the exceptions 

vestrittions (which could mean the sequencer is that might happ en using “throws 

already being used). SomeK indOfException” on their 
method declaration. 
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exception handling 


The compiler needs to know OS tink tiie 
that YOU know youre calling i “IT doo 
a risky method Med Sechy iy Yh, 


If you wrap the risky code in something called a try/ 
catch, the compiler will relax. 


A try/catch block tells the compiler that you know an 
exceptional thing could happen in the method you’re 
calling, and that you’re prepared to handle it. That 
compiler doesn’t care how you handle it; it cares only 
that you say you’re taking care of it. 


import javax.sound.midi.*; 


public class MusicTestl { 


public void play() { 


try { 
i : ky thing m 
Sequencer sequencer = MidiSystem.getSequencer (); 5 Put the ris re the 
s 


System.out.println ("Successfully got a sequencer"); 3 “yey” block. t i 
} catch (MidiUnavailableException e) { “asky” Po 
System.out.print1n ("Bummer"); ethod that r 
LA 
} throw an exte uo 
} ra “Catey” 
oit th or wh 
public static void main(String[] args) { haPPens—, T ional sit z 
u, 
MusicTest1 mt = new MusicTest1(); MidiUnay,;) y er Words, 3 ati 
e 
D a Y the eall to goet Eon is thyg 
l equencer() iji 
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exceptions are objects 


I'm gonna 
TRY this risky thing, 
and I'm gonna 


CATCH myself if I fall. 


An exception is an object... 
of type Exception 


This is fortunate, because it would be much harder to 
remember if exceptions were of type Broccoli. 


Remember from the polymorphism chapters (7 and 8) 
that an object of type Exception can be an instance of 
any subclass of Exception. 


Because an Exception is an object, what you catch is an 
object. In the following code, the catch argument is 
declared as type Exception, and the parameter reference 
variable is ex. 


Don't try this at home. 


Throwable 
getMessage() try { 
A . avin) 
printStackTrace() Jide: ies Gans s yst Vike deel 
4 hod argumen” 
Part of the Exte? ar go a me 
: . They 2 
elass hierarchy i 
tard elas Throwable Exception } catch (Exception e) { 
and herit two key // try to recover 
methods: } N This ĉode 
xcept runs only if an 
io) 
nis thy, yA 
IOException InterruptedException What you write in a catch block depends on the excep- 


tion that was thrown. For example, if a server is down, 
you might use the catch block to try another server. If the 
file isn’t there, you might ask the user for help finding it. 
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exception handling 


If it’s your code that catches the exception, 
then whose code throws it? as ONS MEXCEDHIog 


You'll spend much more of your Java coding time handling excep- 
tions than you'll spend creating and throwing them yourself. For now, 
just know that when your code calls a risky method—a method that 
declares an exception—it’s the risky method that throws the exception 
back to you, the caller. 


your code class witha 


In reality, it might be you who wrote both classes. It really doesn’t mat- risky method 


ter who writes the code...what matters is knowing which method throws 
the exception and which method catches it. 


When somebody writes code that could throw an exception, they must 
declare the exception. 


\d (oy 
me hod UST kel ne we yeseerion 
© Risky, exception-throwing code: pr ynat t throws 3 

public void takeRisk() throws BadException { One method will 

if (abandonAllHope) { 

throw new BadException (); catch what another 

} 

l Rei method throws. An 
= ate 3 new Ex oe 
eet and ay Plin exception is always 
ow it, 


thrown back te the 


caller. 


The method that 


@ Your code that calls the risky method: 
throws has te declare 
public void crossFingers() { o o o 
-n that it might throw 


anObject .takeRisk () ; the exception. 
} catch (BadException e) { 


System. out .printin("Aaargh!") ; 


.printStackT O; j t LEA 
e.printStackTrace T If you tan t recover from the exteption, at LEAST 
stack trace using the PrintStack Trace() method w i 


exceptions inherit. 
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checked and unchecked exceptions 


The compiler checks for everything 
except RuntimeExceptions. 


Exceptions that are NOT subtlasses of 
RuntimeExeeption are checked for by 


the compiler. They're called “checked 
exceptions.” 


© 


Exception 


The Compiler guarantees: 


If you throw an exception in your code, you must declare it using 
the throws keyword in your method declaration. 


© If you call a method that throws an exception (in other words, 
a method that declares it throws an exception), you must 
acknowledge that you're aware of the exception possibility. 
One way to satisfy the compiler is to wrap the call in a try/catch. 
(There’s a second way we'll look at a little later in this chapter.) 


IOException InterruptedException 


RuntimeException 


Lions ave NOT checked by the 


Runti m Exte 


\ They're big a 

iler- n , LIUN, 

~ on a xteptions: You tan throw Tat 
uncherte Exceptions, but yu 


elare Runtime i 
i pe and the compiler wont check 
ave ) 


known as ( 


ClassCastException 


NullPointerException 


there, are_no 


Dumb Questions 


7 Wait just a minute! How come this is the FIRST time 
we've had to try/catch an Exception? What about the 
exceptions I’ve already gotten like NullPointerException 
and the exception for DivideByZero? | even got a 
NumberFormatException from the Integer.parselnt() 
method. How come we didn’t have to catch those? 


A: The compiler cares about all subclasses of Exception, 
unless they are a special type, RuntimeException. Any 
exception class that extends RuntimeException gets a 

free pass. RuntimeExceptions can be thrown anywhere, 
with or without throws declarations or try/catch blocks. 
The compiler doesn’t bother checking whether a method 
declares that it throws a RuntimeException, or whether the 
caller acknowledges that they might get that exception at 
runtime. 
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+ I'll bite. WHY doesn’t the compiler care about those 
runtime exceptions? Aren't they just as likely to bring the 
whole show to a stop? 


A: Most RuntimeExceptions come from a problem in 
your code logic, rather than a condition that fails at runtime 
in ways that you cannot predict or prevent. You cannot 
guarantee the file is there. You cannot guarantee the server 
is up. But you can make sure your code doesn't index off the 
end of an array (that’s what the .length attribute is for). 


You WANT RuntimeExceptions to happen at development 
and testing time. You don’t want to code in a try/catch, for 
example, and have the overhead that goes with it, to catch 
something that shouldn't happen in the first place. 


A try/catch is for handling exceptional situations, not flaws 
in your code. Use your catch blocks to try to recover from 
situations you can't guarantee will succeed. Or at the very 
least, print out a message to the user and a stack trace so 
somebody can figure out what happened. 


-—— BULLET POINTS 
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tree.) 


both of those things). 


a new exception object: 


ducking a little later in this chapter. 


A method can throw an exception when something fails at runtime. 


An exception is always an object of type Exception. (This, as you 
remember from the polymorphism chapters (7 and 8), means the 
object is from a class that has Exception somewhere up its inheritance 


The compiler does NOT pay attention to exceptions that are of 
type RuntimeException. A RuntimeException does not have to be 
declared or wrapped in a try/catch (although you're free to do either or 


All Exceptions the compiler cares about are called “checked 
exceptions,” which really means compiler-checked exceptions. Only 


RuntimeExceptions are excluded from compiler checking. All other 
exceptions must be acknowledged in your code. 


A method throws an exception with the keyword throw, followed by 


throw new NoCaffeineException () ; 


Methods that might throw a checked exception must announce it with 
athrows SomeException declaration. 


If your code calls a checked-exception-throwing method, it must 
reassure the compiler that precautions have been taken. 


If you’re prepared to handle the exception, wrap the call in a try/catch, 
and put your exception handling/recovery code in the catch block. 


If you’re not prepared to handle the exception, you can still make the 
compiler happy by officially “ducking” the exception. We'll talk about 


itive tiP 
metacognitiv' : 
f you're trying to learn sla He 
make that the last thing you try hear 
before going to sleep. So, sie oe n 
book down (assuming you can 
h M e back of a , 
eds time to process wha 
d. That could take 
you try to shove samom 
top of your Java, some 0 

t “stick.” 


you ve read an 
a few hours. If 
new in right on 
the Java might no 


esn't rule out learning 
orking on your latest 
oxing routine 

our Java 


Of course, this = 

nysical skill. 
An Ballroom KickB 
probably won't affect y 
learning. 


For the best results, read this 
book (or at least look at 
the pictures) right before 
going to sleep. 


_________@. Sharpen your pencil 
ere your p 


Which of these do you think 
might throw an exception 
that the compiler should care 
about? These are things that 
you CAN'T control in your code. 
We did the first one. 


(Because it was the easiest.) 


——> Yours to solve. 


Things you want to do 


Connect to a remote server 

__ Access an array beyond its length 
— Display a window on the screen 
__ Retrieve data from a database 


__ See if a text file is where you think it is 


__ Create a new file 


__ Read a character from the command line 


What might go wrong 


The server is down 
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exceptions and flow control 


Flow control in try/catch blocks 


When you call a risky method, one of two things can happen. 
The risky method either succeeds, and the try block completes, 
or the risky method throws an exception back to your calling 
method. 


If the try Succeeds 


(doRiskyThing() does not 
throw an exception) 


try { 
© Foo £ = x.doRiskyThing() ; The code in the 
int b = f.getNum(); tateh blotk never 
Frest the try block vans runs. 
then the code below the } catch (Exception e) { %java Tester 
catth vuns: System.out.println ("failed"); We made it! 
} 


System.out.printin("We made it!"); 


If the try fails 


(because doRiskyThing() 
does throw an exception) 


try { The vest ok 
k runs but the Foo f = x.doRiskyThing (); vuns 
The tey ye Ting) throws int b = £.getNum(); R» 
. be 
tall to p i T ne ves et 
sor) ; = = = > 
an cee block doesn t v4 } catch (Exception e) { 
the ory blot vuns, then System. out .printiln("failed") ; sjava Tester 
ol 


Tre eateh kinues on } failed 
ethod Contr 
the m System.out.printin("We made it!"); We made it! 
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Finally: for the things you want 
to do no matter what 


If you try to cook something, you start by turning on 
the oven. 


If the thing you try is a complete failure, 


you have to turn off the oven. 


If the thing you try succeeds, 
you have to turn off the oven. 


You have to turn off the oven no matter 
what! 


A finally block is where you put 
code that must run regardless 
of an exception. 


try { 
turnOvenoOn (); 
x. bake (); 

} catch ( 


BakingException e) { 


e.printStackTrace(); 
} finally { 
turnOvenOff (); 
} 


Without finally, you have to put the turnOvenOff) 
in both the try and the catch because you have to 
turn off the oven no matter what. A finally 
block lets you put all your important cleanup code 
in one place instead of duplicating it like this: 


try { 
turnOvenoOn () ; 
x. bake (); 
turnOvenOff (); 

} catch (BakingException e) { 

e.printStackTrace(); 


turnOvenOff (); 


exception handling 


Whatever happens, don't 
forget to put the handbrake 
on when we stop. We never 

found out where the last car 
ended up... 


If the try block fails (an exception), flow 
control immediately moves to the catch block. 
When the catch block completes, the finally 
block runs. When the finally block completes, 
the rest of the method continues on. 


If the try block succeeds (no exception), 
flow control skips over the catch block and 
moves to the finally block. When the finally 
block completes, the rest of the method 
continues on. 


If the try or catch block has a return 
statement, finally will still run! Flow 
jumps to the finally, then back to the return. 
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flow control exercise 


—@aSharpen your pencil 
ere your p 


—-»> Yours to solve. 


Look at the code to the left. What do you think the 


Fl. C nt 1 output of this program would be? What do you think 
QW Q ro it would be if the third line of the program were 
changedto String test = "yes";? 


Assume ScaryException extends Exception. 


public class TestExceptions { 
Output when test = "no" 
public static void main(String[] args) { 
String test = "no"; 
try { 
System.out.printin("start try"); 
doRisky (test) ; 
System.out.printin("end try"); 
} catch (ScaryException se) { 
System.out.println("scary exception"); 
} finally { 
System.out.println ("finally") ; 
} 


System.out.printin("end of main"); 


static void doRisky(String test) throws ScaryException { Output when test = "yes" 
System.out.printin("start risky"); 
if ("yes".equals(test)) { 
throw new ScaryException () ; 


} 
System.out .println ("end risky"); 


class ScaryException extends Exception { 


} 
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exception handling 


Vid we mention that a method can 
throw wore than one exception? 


A method can throw multiple exceptions if it darn well needs to. But a method’s 
declaration must declare all the checked exceptions it can throw (although if two 
or more exceptions have a common superclass, the method can declare just the 
superclass). 


Catching multiple exceptions 


The compiler will make sure that you’ve handled all the checked exceptions 
thrown by the method you're calling. Stack the catch blocks under the try, one 
after the other. Sometimes the order in which you stack the catch blocks matters, 
but we'll get to that a little later. 


public class Laundry { 
public void doLaundry() throws PantsException, CTR ean { 


// code that could throw either exception , 
em) 


t 
} Thi 9 declares do, Lor 
1s 
TWO exceptar: 
public class WashingMachine { 
public void go() { 
Laundry laundry = new Laundry(); I£ doLaundry() throws a 
try { PantsExteption, it lands in the 
laundry .doLaundry (); < PantsException tateh block. 
} catch (PantsException pex) { 
// recovery code 
} catch (LingerieException lex) { 4 
// recovery code tN if dol Laundry throws oh ne 
} LingevieErcer™ it lan i 
o 
} Lingerie neertin cath 
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polymorphic exceptions 


Exceptions are polymorphic 


Exceptions are objects, remember. There’s nothing all that special 
about one, except that it is a thing that can be thrown. So like all 
good objects, Exceptions can be referred to polymorphically. 

A LingericException object, for example, could be assigned to a 
ClothingException reference. A PantsException could be assigned 
to an Exception reference. You get the idea. The benefit for 
exceptions is that a method doesn’t have to explicitly declare every 
possible exception it might throw; it can declare a superclass of the 
exceptions. Same thing with catch blocks—you don’t have to write 
a catch for each possible exception as long as the catch (or catches) 
you have can handle any exception thrown. 


@) You can DECLARE exceptions using a 
superclass of the exceptions you throw. 


Lit 


public void doLaundry() throws ClothingExceptic 


@ You can CATCH exceptions using a 
superclass of the exception thrown. 


try { Can eateh avy 
laundry .doLaundry (); c strina g cepton 


E ' MIN 4 \ ae suloclass 
‘i’ 


} catch(ClothingException cex) { 
// recovery code 
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n "i 


All exceptions have 


Exception Exception as a 
superclass: 


lOException ClothingException 


LingerieException ShirtException 


PantsException 


i) 


DressShirtException 


TeeShirtException 


try { Deesschirtente? na 
laundry.doLaundry (); 
} catch (ShirtException shex) { 


// recovery code 


} 


exception handling 


Just because you CAN catch everything 
with one big super polymorphic catch, 
doesn’t always mean you SHOULD. 


You could write your exception-handling code so that you 
specify only one catch block, using the superclass Exception 
in the catch clause, so that you'll be able to catch any excep- 
tion that might be thrown. 


try { From WHAT? This catth block ik 
laundry.doLaundry () ; Recovery trom teptions, so YO won t 
} catch (Exception ex) { sateh ANY and all ex i sak avori 
// recovery code... GQ automatically know what w 
} 


Write a different catch block for each 
exception that you need to handle 
uniquely. 


For example, if your code deals with (or recovers from) 

a TeeShirtException differently than it handles a 
LingerieException, write a catch block for each. But if you treat 
all other types of ClothingException in the same way, then add 
a ClothingException catch to handle the rest. 


try { 
laundry .doLaundry () ; 


& jars and forent 
ek Excertions 2 afferen 
} catch (TeeShirtException tex) {¢—~ Teeswet pions need i. d vse 
// recovery from TeeShirtException Linger e so 1 


to 
eene eks- 
KO" / “sere eaten ble 
} catch (LingerieException lex) { 
// recovery from LingerieException 


ive, 
ce i L All other Clothin 


} catch (ClothingException cex) { are Caught here. 
// recovery from all others 


9Exee Ptions 
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order of multiple catch blocks 


Multiple catch blocks must be ordered 


from smallest to biggest 


a ions 6 
CERTE? esitteet i oher 


First 


catch (ShirtException sex) 


catch (ClothingException cex) 
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ClothingException 


PantsException 


LingerieException 


ShirtException 


UniformException 


bb 


TeeShirtException 


piuning 


DressShirtException 


The higher up the inheritance tree, the bigger the catch 
“basket.” As you move down the inheritance tree, toward 
more and more specialized Exception classes, the catch 
“basket” is smaller. It’s just plain old polymorphism. 


A ShirtException catch is big enough to take a 
TeeShirtException or a DressShirtException (and any 
future subclass of anything that extends ShirtException). 
A ClothingException is even bigger (1.e., there are more 
things that can be referenced using a ClothingException 
type). It can take an exception of type ClothingException 
(duh) and any ClothingException subclasses: 
PantsException, UniformException, LingericException, 
and ShirtException. The mother of all catch arguments 
is type Exception; it will catch any exception, including 
runtime (unchecked) exceptions, so you probably won’t 
use it outside of testing. 


You cant put bigger baskets 
above smaller baskets 


Well, you can, but it won’t compile. Catch blocks 
are not like overloaded methods where the best 
match is picked. With catch blocks, the JVM 
simply starts at the first one and works its way 
down until it finds a catch that’s broad enough 
(in other words, high enough on the inheritance 
tree) to handle the exception. If your first 

catch block is catch (Exception ex), the 
compiler knows there’s no point in adding any 
others—they’ll never be reached. 


bast 


try { 


laundry.doLaundry (); 


} catch(ClothingException cex) { 
// recovery from ClothingException 


} catch (LingerieException lex) { 
// recovery from LingerieException 


} catch(ShirtException shex) { 
// recovery from ShirtException 


} 


exception handling 


Size matters when 
you have multiple catch 
blocks. The one with the biggest 
basket has to be on the bottom. 
Otherwise, the ones with 
smaller baskets are useless. 


Siblings (exceptions at the same level of 
the hierarchy tree, like PantsException 
and LingerieException) can he in any 
order, because they can’t catch one 
another's exceptions. 


You could put ShirtException above 
LingericException, and nobody would mind. 
Because even though ShirtException is a bigger 
(broader) type because it can catch other classes 
(its own subclasses), ShirtException can’t catch a 


LingericException, so there’s no problem. 
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polymorphic puzzle 


Assume the try/catch block here is legally coded. Your task is to draw two 


G harpen your pencil different class diagrams that can accurately reflect the Exception classes. 
In other words, what class inheritance structures would make the try/ 
IN catch blocks in the sample code legal? 


try { 

x.doRisky () ; 
} catch(AlphaEx a) { 

// recovery from AlphaEx 
} catch (BetaEx b) { 

// recovery from BetaEx 
} catch (GammaEx c) { 

// vecovery from GammaEx 
} catch (DeltaEx d) { 

// recovery from DeltaEx 


} 

Your task is to create two different /egal try/catch structures (similar to the 
one above left) to accurately represent the class diagram shown on the 
left. Assume ALL of these exceptions might be thrown by the method with 

BazEx the try block. 

FooEx 

BarEx BiffEx 
BoinkEx 
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exception handling 


When you don’t want to handle 
an exception... 


What the...? 


There is NO way I'm 
catching that thing. I'm gettin’ 
out of the way—somebody 
behind me can handle it. 


If you don’t want to handle an 
exception, you can duck it by 
declaring it. 


When you call a risky method, the compiler needs 
you to acknowledge it. Most of the time, that 
means wrapping the risky call in a try/catch. But 
you have another alternative: simply duck it and let 
the method that called you catch the exception. 


It’s easy—all you have to do is declare that you throw 
the exceptions. Even though, technically, you aren’t 
the one doing the throwing, it doesn’t matter. 
You're still the one letting the exception whiz right 
on by. 


But if you duck an exception, then you don’t 
have a try/catch, so what happens when the risky 
method (doLaundry()) does throw the exception? 


When a method throws an exception, that method 
is popped off the stack immediately, and the 
exception is thrown to the next method down the 
stack—the caller. But if the caller is a ducker, then 
there’s no catch for it, so the caller pops off the 
stack immediately, and the exception is thrown to 
the next method and so on...where does it end? 
You'll see a little later. 


public void foo() throws ReallyBadException { snte ia . method YO" 


od- 

// call risky method without a try/catch VOU are now ar tal you 

laundry .doLaundry () ; Be ith the exterior 
has 
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handle or declare 


Ducking (by declaring) only 
delays the inevitable 


Sooner or later, somebody has to 
deal with it. But what if main() 
ducks the exception? 


public class Washer { 
Laundry laundry 


public void foo() throws ClothingException { 
laundry.doLaundry () ; 


} 


public static void main (String[] args) throws ClothingException { 
new Washer (); 


Washer a 
a.foo(); 
} 
} 


doLaundry() throws a 
ClothingException 


main() calls foo() 


foo() calls doLaundry() 


doLaundry() is 
running and throws a 
ClothingException 


cy, We're using the T-shirt to represent a Clothing 
Exception. We know, we know...you would have 
preferred the blue jeans. 


442 chapter 13 


new Laundry (); 


foo() ducks the 


doLaundry() pops off the 
stack immediately, and 
the exception is thrown 


But foo() doesn't have a 
try/catch, so... 


wl 
poo nae 
ane Ry Twist 
harn 


main() ducks the 
exception 


foo() pops off the 
stack, and the excep- 
tion is thrown back 
to main(). But main() 
doesn't have a try/ 
catch, so the excep- 


tion is thrown back to... 


who? What? There's 
nobody left but the 
JVM, and it's thinking, 
“Don't expect ME to 
get you out of this.” 


The JVM 
shuts down 


exception handling 


Handle or Declare. It’s the law. 


So now we’ve seen both ways to satisfy the compiler 
when you call a risky (exception-throwing) method. 


@ HANDLE 


Wrap the risky call in a try/catch This had better be 


a bi en h 
try { handle all exceptio,- p > non Catch to 
laundry.doLaundry () ; yoo SE exceptions that dol_aundry() 


might throw. O ; 
} catch (ClothingException cex) { st] eae raed — will 
not Catching all 


// recovery code he except 
ons. 


@ DECLARE (duck it) 


Declare that YOUR method throws the same exceptions 


‘ ' i v 
as the risky method you're calling. Tre goL-aundry by declaring the 


. jon, OV 
void foo() throws ClothingException { Clothing-*te tool method gets 
laundry.doLaundry () ; T exception ae ð tey 
} utk the exception 
But now this means that whoever calls the foo() method 
has to follow the Handle or Declare law. If foo() ducks 
the exception (by declaring it) and main() calls foo(), then 
main() has to deal with the exception. 
public class Washer { 
Laundry laundry = new Laundry (); 
public void foo() throws ClothingException { 
laundry.doLaundry ();}; 
} TROUBLE!! 
) rome an 
public static void main (String[] args) { Now engin) won tention 
Washer a = new Washer (); “ reported 
ek an W ne Compre 
a.foo(); E) hs far as ss i thod throws 
} error: fe me 
he x00 
} Because the fool) method ducks the concerned 
ClothingExeeption heen 1 i exteruion 


i y doLaundr 0), j 
main() has to wrap afool) in a neri 


or mainl) has to declare that it, too, 
throws ClothingException! . 
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fixing the Sequencer code 


Getting back to our music code... 


Now that you’ve completely forgotten, we started this chapter with a 
first look at some JavaSound code. We created a Sequencer object, but 
it wouldn’t compile because the method Midi.getSequencer() declares 
a checked exception (MidiUnavailableException). But we can fix that 


now by wrapping the call in a try/catch. 


public void play() { 
try { 


Sequencer sequencer = MidiSystem.getSequencer () ; 
System.out.printin("Successfully got a sequencer"); 


hee 


« < Sateh 
} catch (MidiUnavailableException e) { p e” enep ameter has tob 
System.out.println ("Bummer"); 1 dExeep Sij: if We said a th 
} mt Compile, bert the ode FileNot 
} Unavilap “SE Police, Would 
ileNot eE ept rPhiea/) 
ndExeep ee. fi into 
ememb 
block. : i t Enough 
thrown) "E to eaten ap) a cates 
bein 
Exception Rules 


You cannot have a catch or finally 
without a try. 


void go() { 


NOT LEGAL 
the tef 


Foo f = new Foo(); i 
s 
f fóoöf()}; Where 


catch (FooException ex) { } 


You cannot put code between the 

try and the catch. 

try { / j 
x.doStuff(); Code between t 


} the tateh. 
int y = 43; 


} catch (Exception ex) { } 
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@ A try MUST be followed by either a 
catch or a finally. LEGAL 
b 


try { have af Pes You 
x.doStuff(); though i ” even 
} finally { Cate B, eres ho 
// cleanup have at You Cannot 
} y by itself 


@ Atry with only a finally (no catch) 


must still declare the exception. 


void go() throws FooException { 


try { . ka eatth 
x.doStuff (); i try ee the 
| finally { } doesn t satis*y m 
l pandle or declare 


k + 
x Code Kitchen 


Vi 


Everything 
you see I made 
myself from scratch. 


Was that more 
satisfying than 
using Ready-Bake 
Code? 


exception handling 


You don’t have to do it 
yourself, but it’s a lot 
more fun it you do. 


The rest of this chapter 


is optional: you can use 
Ready-Bake Code for all 
the music apps. 


But if you want to learn 
more about JavaSound, 
turn the page. 
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JavaSound MIDI classes 


Making actual sound 


Remember near the beginning of the chapter, we looked at how MIDI data holds the 
instructions for what should be played (and how it should be played) and we also said 
that MIDI data doesn’t actually create any sound that you hear. For sound to come out of the 
speakers, the MIDI data has to be sent through some kind of MIDI device that takes 
the MIDI instructions and renders them in sound, by triggering either a hardware in- 
strument or a “virtual” instrument (software synthesizer). In this book, we’re using only 
software devices, so here’s how it works in JavaSound: 


The thing that 
plays the music 


plays 
Sequencer 


The Sequencer is the thing 
that actually causes a song 
to be played. Think of it like 
a smart speaker streaming 
music. 
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You need FOUR things: 


The music to be 
played...a song. 


has a 


Sequence i 


The Sequence is the 
song, the single piece 
of music that the 
Sequencer will play. 


The part of the 
Sequence that 
holds the actual 
information 


Track 


For this book, all we 
want to do will fit on a 
single track, so for us 
one song needs only 
one track. This Track 

is where all the song 
data (MIDI information) 
lives. 


© The actual music 
information: notes 
to play, how long, 
etc. 


A MIDI event is a message 
that the Sequencer can 
understand. A MIDI event 
might say (if it spoke 
English), “At this moment 
in time, play middle C, play 
it this fast and this hard, 
and hold it for this long. “ 


A MIDI event might 
also say something like, 
“Change the current 
instrument to Flute.” 


exception handling 


And you need FIVE steps: 


@) Get a Sequencer and open it 


Sequencer player = MidiSystem.getSequencer (); 
player.open(); 


@) Make a new Sequence 


Sequence seq = new Sequence (timing, 4) ; 


@) Get anew Track from the Sequence 


Track t = seq.createTrack (); 


@ Fill the Track with MidiEvents and 
give the Sequence to the Sequencer 


t.add(myMidiEvent1) ; 
player.setSequence (seq) ; 


Ahhhh. We 
forgot to push the 

PLAY button. You have to 

start() the Sequencer! 


Uh, hate to break it 
to you, but that's only 
FOUR steps. 


player.start (); 
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a sound application 


Version 1: Your very first sound player app 


Type it in and run it. You'll hear the sound of someone playing a single 
note on a piano! (OK, maybe not someone, but something.) 


Don’t £o 
oe ntk rget to import the midi 


import javax.sound.midi.*; Package. 
import static javax.sound.midi.ShortMessage. *; We've using a statie import here so we Can 
stants in the ShortMessage elass. 
public class MiniMiniMusicApp { use the Con 
public static void main(String[] args) { 
MiniMiniMusicApp mini = new MiniMiniMusicApp () ; 


mini.play () ; 
: nc a Ren i 
Ger a Sequen’e a Seauent e 
public void play() { eae tan vse 7 jy over)” 
try { Ta ee pome WE? y 
© Sequencer player = MidiSystem.getSequencer () ; P goes” 
player.open(); is the 


Sequence seq = new Sequence (Sequence.PPQ, 4); Sequence ton 


(think of ‘em as 


Track track = seq.createTrack () | Ask the Sequence for a Track. Remember the 


Tratk lives in the Se 
ce, 
lives in the Track. ence, and the MIDI data 


ShortMessage msgl = new ShortMessage() ; 


msgl.setMessage(NOTE_ON, 1, 44, 100); Put some MidiEvents into the 
MidiEvent noteOn = new MidiEvent (msgl, 1); Track. This part is mostly Readies 
track .add(noteOn) ; Bake Code: The onl thi , Yy 

Y thing you ll 
ShortMessage msg2 = new ShortMessage() ; have to care about are the 
msg2.setMessage(NOTE_OFF, 1, 44, 100); arguments to the setMessage() 
MidiEvent noteOff = new MidiEvent (msg2, 16); method, and the arguments to the 
track .add(noteOff) ; MidiEvent constructor. We'll look at 


those arguments on the next page. 


player. setSequence (seq) ; C— Give the Sequence to the Sequencer (like 
selecting the song to play). 


player.start (); — start() the Seq 
uncer 


Play the song). 


catch (Exception e) { 
e.printStackTrace () ; 


~ 


} 
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exception handling 


Making a Miditvent (song data) 


A MidiEvent is an instruction for part of a song. A series of MidiEvents is kind 
of like sheet music, or a player piano roll. Most of the MidiEvents we care about A MidiEvent Says 


describe a thing to do and the moment in time to do it. The moment in time | d ] | 
part matters, since timing is everything in music. This note follows this note and so what to o vnen 


on. And because MidiEvents are so detailed, you have to say at what moment to to do tt. 

start playing the note (a NOTE ON event) and at what moment to stop playing the 

notes (NOTE OFF event). So you can imagine that firing the “stop playing note mst ° 

G” (NOTE OFF message) before the “start playing Note G” (NOTE ON) message Every Tuction 
wouldn’t work. must include the 
The MIDI instruction actually goes into a Message object; the MidiEvent is a timing for that 


combination of the Message plus the moment in time when that message should 2 : 
“fire.” In other words, the Message might say, “Start playing Middle C,” while the instruchon. 
MidiEvent would say, “Trigger this message at beat 4.” 


So we always need a Message and a MidiEvent. In other words, 
The Message says what to do, and the MidiEvent says when to do it. at which beat that 


thing should happen. 


@ Make a Message 


ShortMessage msg = new ShortMessage(); 


© Put the Instruction in the Message «tart playind rote WM 
msg.setMessage(144, 1, 44, 100); C mee a numbers m e 
we 
next page): 


@) Make a new MidiEvent using the Message 


MidiEvent noteOn = new MidiEvent (a, 1); 


The instructions are in the message, b t th 
MidiEvent adds the moment in ei ae th 

© Add the MidiEvent to the Track ai un i Bee he dEi i 
Al the Mire 1 (ger message ‘a’ at the first beat (beat 1). 


A Track holds all the MidiEvent objects: The Se 
them atcording to when each event is mune — ae 
the Sequencer plays them back in that waer: i . nae 
vents happening at the exact same moment in Time. san 
: ight want two notes played simultaneously, or even di 
ou m 


instruments playing different sounds at the same Lime. 
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contents of a Midi event 


MIDI message: the heart of a MidiEvent 


A MIDI message holds the part of the event that says what to do. It’s the actual instruction you 
want the sequencer to execute. The first argument of an instruction is always the type of the 
message. The values you pass to the other three arguments depend on the type of message. For 
example, a message of type 144 means “NOTE ON.” But in order to carry out a NOTE ON, the 
sequencer needs to know a few things. Imagine the sequencer saying, “OK, Pll play a note, but 
which channel? In other words, do you want me to play a Drum note or a Piano note? And which 
note? Middle-C? D Sharp? And while we’re at it, at which velocity should I play the note? 


To make a MIDI message, make a ShortMessage instance and invoke setMessage(), passing in the 
four arguments for the message. But remember, the message says only what to do, so you still need 
to stuff the message into an event that adds when that message should “fire.” 


Anatomy of a message The Message says what to do: the 
The first argument to setMessage() always sds ‘ 
represents the message “type,” while the other MidiEvent say. 5 when to do it. 


three arguments represent different things 
depending on the message type. 


ot N O M @ Channel 
ee OE Ql Think of a channel like a musician in 
msg.setMessage(144, 1, 44, 100); a band. Channel 1 is musician 1 (the 
The | keyboard player), channel 9 is the 
Via ih args vary dependi, drummer, etc. 
the othe tt: This is a NOTE Dy 
as er args are for th; m sage, so 
eds to k ings the 


; Sı 
"oW in order to play a n aad © Note to play 


ote. 


A number from O to 127, going 
from low to high notes. 


@) Message type 


144 means 
NOTE ON 


128 means 
NOTE OFF 


[4 


@ Velocity # 


How fast and hard did you press the 
key? O is so soft you probably won't hear 
anything, but 100 is a good default. 
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Change a message 


Now that you know what’s in a MIDI message, you can start experimenting. You can 
change the note that’s played, how long the note is held, add more notes, and even 
change the instrument. 


@) Change the note 


Try a number between O and 127 in the note 
onand note off messages. 


msg.setMessage(144, 1, 20, 100); \ 


@ Change the duration of the note 
Change the note off event (not the message) so 
that it happens at an earlier or later beat. 
msg.setMessage(128, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent (b, 3) H 


— 


\ 


\ 


@) Change the instrument 


Add a new message, BEFORE the note-playing message, 
that sets the instrument in channel 1 to something other 
than the default piano. The change-instrument message 
is "192," and the third argument represents the actual 
instrument (try a number between O and 127). 


first.setMessage(192, 1, 102, 0); 


or 
S ca gt 
Pa \ (or oom 
oo sear? xp 
of we 
ot 
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change the instrument and note 


Version 2: Using command-line args to experiment with sounds 


This version still plays just a single note, but you get to use command-line arguments to 
change the instrument and note. Experiment by passing in two int values from 0 to 127. 
The first int sets the instrument; the second int sets the note to play. 


import javax.sound.midi.*; 
import static javax.sound.midi.ShortMessage.*; 


public class MiniMusicCmdLine { 
public static void main(String[] args) { 
MiniMusicCmdLine mini = new MiniMusicCmdLine()j; 
if (args.length < 2) { 
System.out.printin("Don’t forget the instrument and note args"); 


} else { 
int instrument = Integer.parselInt (args[0]); 
int note = Integer.parselInt (args[1]); 


mini.play (instrument, note); 


public void play(int instrument, int note) { 
try { 
Sequencer player = MidiSystem.getSequencer (); 
player.open (); 
Sequence seq = new Sequence (Sequence.PPQ, 4); 
Track track = seq.createTrack (); 


ShortMessage msgl = new ShortMessage(); 
msgl.setMessage (PROGRAM_CHANGE, 1, instrument, 0); 
MidiEvent changeInstrument = new MidiEvent(msgl, 1); 
track.add(changeInstrument) ; 


ShortMessage msg2 = new ShortMessage(); 
msg2.setMessage (NOTE_ON, 1, note, 100); 
MidiEvent noteOn = new MidiEvent (msg2, 1); 
track.add(noteOn) ; 


Run it with two int args from O 
ShortMessage msg3 = new ShortMessage(); to 127. Try these for starters: 


msgd:setMessage (NOTE_OFF; Tr noter 100); 
MidiEvent noteOff = new MidiEvent (msg3, 16); 


track.add(noteOff) ; % java MiniMusicCmdLine 102 30 


%$ java MiniMusicCmdLine 80 20 
player.setSequence (seq) ; 


player.start(); 


%$ java MiniMusicCmdLine 40 70 


} catch (Exception ex) { 
ex.printStackTrace(); 
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Where were headed with the rest 


of the CodeKitchens 


Chapter 17: the goal 


When we're done, we'll have a working 
BeatBox that's also a Drum Chat Client. 
We'll need to learn about GUIs (includ- 
ing event handling), I/O, networking, and 
threads. The next three chapters (14, 15, 


and 16) will get us there. 


Chapter 14: MIDI events 


This CodeKitchen lets us build a little 
“music video" (bit of a stretch to call it 
that...) that draws random rectangles to 
the beat of the MIDI music. We'll learn 
how to construct and play a lot of MIDI 
events (instead of just a couple, as we do 


in the current chapter). 


Chapter 15: Standalone 


BeatBox 


Now we'll actually build the real BeatBox, 
GUI and all. But it's limited—as soon as you 
change a pattern, the previous one is lost. 
There's no Save and Restore feature, and 
it doesn't communicate with the network. 
(But you can still use it to work on your 


drum pattern skills.) 


Chapter 16: Save and 


Restore 


You've made the perfect pattern, and now 
you can save it to a file and reload it when 
you want to play it again. This gets us 
ready for the final version (Chapter 15), 
where instead of writing the pattern toa 
file, we send it over a network to the chat 


server. 
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Bass Drum 
Closed Hi-Hat 
Open Hi-Hat 
Acoustic Snare 
Crash Cymbal 
Hand Clap 
High Tom 

Hi Bongo 
Maracas 
Whistle 

Low Conga 
Cowbell 
Vibraslap 
Low-mid Tom 
High Agogo 
Open Hi Conga 


‘eee Cyber BeatBox 


Start 
Tempo Up 
Tempo Down 


sendit 


River: groove #2 
Brooklyn: groove2 revised 


BoomTish: dance beat 


beat one beat two 
eee Cyber BeatBox 
Bass Drum 
Closed Hi-Hat 
Open Hi-Hat 
Acoustic Snare 
Crash Cymbal 
Hand Clap 
High Tom iv} 
Hi Bongo 
Maracas 
Whistle 
Low Conga 
Cowbell 
Vibraslap 


Low-mid Tom 
High Agogo 


Open Hi Conga 
q d 
O 


eee Cyber BeatBox 
Bass Drum 

Closed Hi-Hat 

Open Hi-Hat 

Acoustic Snare 

Crash Cymbal 

Hand Clap 

High Tom 
Hi Bongo 

Maracas 

Whistle 

Low Conga 

Cowbell 

Vibraslap 

Low-mid Tom 

High Agogo 

Open Hi Conga 


beat three 


beat four 


Start 
Stop 
Tengan. 


Tempo Down 


Start 

Tempo Up 
Tempo Down 
serializelt 


restore 
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exercise: True or False 


This chapter explored the wonderful world of 
exceptions. Your job is to decide whether each of the 
following exception-related statements is true or false. 


Trve or Farse $ 


1. A try block must be followed by a catch and a finally block. 


2. If you write a method that might cause a compiler-checked exception, you must wrap 
that risky code in a try/catch block. 


3. Catch blocks can be polymorphic. 

4. Only “compiler checked” exceptions can be caught. 

5. If you define a try/catch block, a matching finally block is optional. 

6. If you define a try block, you can pair it with a matching catch or finally block, or both. 


7. If you write a method that declares that it can throw a compiler-checked exception, 


you must also wrap the exception throwing code in a try/catch block. 

8. The main( ) method in your program must handle all unhandled exceptions thrown to it. 
9. A single try block can have many different catch blocks. 

10. A method can throw only one kind of exception. 

11. A finally block will run regardless of whether an exception is thrown. 

12. A finally block can exist without a try block. 

13. A try block can exist by itself; without a catch block or a finally block. 

14, Handling an exception is sometimes referred to as “ducking.” 

15. The order of catch blocks never matters. 


16. A method with a try block and a finally block can optionally declare a 


checked exception. 


17. Runtime exceptions must be handled or declared. 


————> Answers on page 457. 
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| 2x6 
pi Code Magnets 


A working Java program is scrambled up on the fridge. Can you reconstruct 
all the code snippets to make a working Java program that produces the 
output listed below? Some of the curly braces fell on the floor and they 
were too small to pick up, so feel free to add as many of those as you need! 


keti 


System. out.print ("t"); 
t 


system.out.print ("r"); 


doRisky (test); 


System.out.println ("s"); 


System.out.print ("0o"); 


class MyEx extends Exception { } 


public class ExTestDrive { 


gystem.out. print ("w"); 


if ("yes" 


System.out.print ("a"); | 


static void doRisky (String t) 


-quals (t)) { 


throws MyEx { 


System.out.print ("h"); 


File Edit Window Help ThrowUp 
java ExTestDrive yes 
thaws 


] args) { 


public static void main(String [ 


Q 


% java ExTestDrive no 


string test = args[0]; 


throws 


————— Answers on page 458. 
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puzzle: crossword 


JavaCress 


> Answers on page 459. 


Across 

1. To give value 

4. Flew off the top 
6. All this and more! 
8. Start 

10. The family tree 
13. No ducking 

15. Problem objects 


18. One of Java's ‘49’ 


20. Class hierarchy 

21. Too hot to handle 

24. Common primitive 
25. Code recipe 

27. Unruly method action 
28. No Picasso here 


29. Start a chain of events 


Down 

2. Currently usable 

3. Template's creation 
4. Don't show the kids 
5. Mostly static API class 
7. Not about behavior 
9. The template 


11. Roll another one off 


More Hints: 
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ayab, e JON ‘ZL 
UNO, Ajlwey əy} ‘OL 
ynejap Jo a1qGnd Aju ‘6 


the line 
++ SJOQUINN “S 
(a|}dwexa jou) 104 'Ẹ 
ysemųynow e10 ‘Z 
umogq 


12. Javac saw it coming 
14. Attempt risk 

16. Automatic acquisition 
17. Changing method 


19. Announce a duck 


22. Deal with it 
23. Create bad news 


26. One of my roles 


pensqy ION “87 

wa|qoid e syeys "77 

eNO “LZ 

uo1}29]]02 Jo adA} e OS] “OZ 


You know what 
to do! 


auejpap Jo peaysu ‘EL 
poyu e eis '8g 
piy» eser *9 
ssonDy 


§ oļu t on DeltaEx 
G harpen your pencil 
DN 
(from page 440) 
GammaEx 
BetaEx 
AlphaEx 
Exercise Solution 


Trve OR False (from page 454) 


— 


. False, either or both. 
. False, you can declare the exception. 
True. 

False, runtime exception can be caught. 
. True. 
. True, both are acceptable. 
. False, the declaration is sufficient. 


. False, but if it doesn’t, the JVM may shut 
down. 


9. True. 


exception handling 


DeltaEx 


BetaEx GammaEx 


AlphaEx 


10. False. 


11. True. It’s often used to clean up partially 
completed tasks. 


12. False. 
13. False. 
14. False, ducking is synonymous with declaring. 


15. False, broadest exceptions must be caught by 
the last catch blocks. 


16. False, if you don’t have a catch block, you 
must declare. 


17. False. 
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exercise solutions 


be» Exercise Solutions 


Code Magnets (from page 455) 


class MyEx extends Exception { } 


public class ExTestDrive { 
public static void main(String[] args) { 
String test = args[0]; 
try { 
System.out.print ("t"); 
doRisky (test); 
System.out.print ("o"); 
} catch (MyEx e) { 
System.out.print ("a"); 
} finally { 
System.out.print ("w"); 
} 


System.out.printin("s"); 


static void doRisky(String t) throws MyEx { 
System.out.print ("h"); 


td 


if ("yes".equals(t)) { 
throw new MyEx () 


i File Edit Window Help Chill 
tite: 


} % java ExTestDrive yes 
} thaws 


% java ExTestDrive no 
throws 
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14 getting gui 


A Very Graphic 
Story 


Theard youre could Wow! This looks great. 


only cook command-line I guess presentation 


meals. really is everything. 


Face it, you need to make GUIs. If you're building applications that other people 
are going to use, you need a graphical interface. If you're building programs for yourself, you 
want a graphical interface. Even if you believe that the rest of your natural life will be spent 
writing server-side code, where the client user interface is a web page, sooner or later you'll 
need to write tools, and you'll want a graphical interface. Sure, command-line apps are retro, 
but not in a good way. They're weak, inflexible, and unfriendly. We'll spend two chapters 
working on GUIs and learn key Java language features along the way including Event 
Handling and Inner Classes and lambdas. In this chapter, we'll put a button on the screen, 
and make it do something when you click it. We'll paint on the screen, we'll display a JPEG 


image, and we'll even do some (crude) animation. 
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your first gui 


It all starts with a window 


A JFrame is the object that represents a 
window on the screen. It’s where you put all 
the interface things like buttons, check boxes, 
text fields, and so on. It can have an honest- 
to-goodness menu bar with menu items. 

And it has all the little windowing icons for 
whatever platform you’re on, for minimizing, 
maximizing, and closing the window. 


The JFrame looks different depending on the 
platform you’re on. This is a JFrame on an old 
Mac OS X: 


000 


File Panic Deviate 


Put widgets in the window 


Once you have a JFrame, you can put things 


(“widgets”) in it by adding them to the JFrame. 


There are a ton of Swing components you 
can add; look for them in the javax.swing 
package. The most common include JButton, 
JRadioButton, JCheckBox, JLabel, JList, 
JScrollPane, JSlider, JTextArea, JTextField, 
and JTable. Most are really simple to use, 

but some (like JTable) can be a bit more 
complicated. 
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Two issues! 
1. Swing? This looks like Swing code. 
You're really gonna teach us Swing? 
2. That window looks really 

old-fashioned. 


She’s asked a couple of really good 
questions. In a few pages we'll ad- 
dress these questions with an extra- 
special “No Dumb Questions.” 


Making a GUI is easy: 


@ Make a frame (a JFrame) 


JFrame frame = new JFrame(); 


© Make a widget (button, text field, etc.) 


JButton button = new JButton ("click me"); 


@ Add the widget to the frame 
frame .getContentPane() .add (button) ; 


around the wi € Trame as the trim 
ai window, and you add things b 


@ Display it (give it a size and make it visible) 
frame.setSize (300, 300); 
frame.setVisible (true); 


getting gui 


Your first GUI: a button on a frame 
dont forget to impor t 


import javax.swing.*; this swing package 


public class SimpleGuil { 
public static void main(String[] args) { ga button 
e LA) 
make a {cam ton tonstruttor 


SS ut 
eE (you tan pa the b the hutt) 


g the text you want on 
JButton button = new JButton ("click me"); 


JFrame frame = new JFrame (); 


frame .setDefaultCloseOperation (JFrame .EXIT_ON_CLOSE) ; 
this line makes the 

lose the window as 

Just sit there on the 


rogram quit aS Soon as you 
You leave this out it will 


frame .getContentPane() .add (button) ; séreen forever) 


N~ add the button to the frame’ 
frame.setSize(300, 300); content Pane meS 


Jive the frame Ja 
frame.setVisible (true) ; Size, in Pixels 


} finally, make it visible!! GF you forget 


his step, : : 
pon es bin 


Let’s see what happens when we run it: 
Sjava SimpleGuil 


Whoa! That’s a 
Really Big Button. 


The button fills all the 
RSIS available space in the frame. 
Later we'll learn to control 
where (and how big) the 


button is on the frame. 


| 
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user interface events 


But nothing happens when | click it... 


That’s not exactly true. When you press the button, it shows that 
“pressed” or “pushed in” look (which changes depending on the 
platform look and feel, but it always does something to show when it’s 
being pressed). 


The real question is, “How do I get the button to do something specific 
when the user clicks it?” 


We need two things: 


© a method to be called when the user 
clicks (the thing you want to happen as 
a result of the button click). 


© a way to know when to trigger 
that method. In other words, a way 
to know when the user clicks the 
button! 


When the user clicks, we want 
to know. 


We’re interested in the user- 
takes-action-on-a-button event. 
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thereareno 
1b Questions 


Q: | heard that nobody uses 
Swing anymore. 


There are other options, 
like JavaFX. But there are no clear 
winners in the endless and ongo- 
ing “Which approach should | use 
to make GUls in Java?” debate. The 
good news is that if you learn a little 
Swing, that knowledge will help 
you whichever way you end up go- 
ing. For example, if you want to do 
Android development, your Swing 
knowledge will make learning to 
code Android apps easier. 


Q: Will a button look like a 
Windows button when you run on 
Windows? 


A: If you want it to. You can 
choose from a few “look and 


feels”—classes in the core library 
that control what the interface looks 
like. In most cases you can choose 
between at least two different looks. 
The screens in this book use a 
number of “look and feels,” includ- 
ing the default system look and feel 
(for macOS), the OS X Aqua look and 
feel, or the Metal (cross platform) 
look and feel. 


Q: Isn't Aqua really old? 


A: Yes, but we like it. 


Getting a user event 


Imagine you want the text on the button to change 
from click me to I’ve been clicked when the user presses 
the button. First we can write a method that changes 
the text of the button (a quick look through the API 
will show you the method): 


public void changeIt() { 
button.setText ("I’ve been clicked!") ; 


} 


But now what? How will we know when this method 
should run? How will we know when the button 
is clicked? 


In Java, the process of getting and handling a user 
event is called event-handling. There are many different 
event types in Java, although most involve GUI user 
actions. If the user clicks a button, that’s an event. 
An event that says “The user wants the action of 
this button to happen.” If it’s a “Slow the Tempo” 
button, the user wants the slow-the-music-tempo 
action to occur. If it’s a Send button on a chat 
client, the user wants the send-my-message action to 
happen. So the most straightforward event is when 
the user clicked the button, indicating they want an 
action to occur. 


With buttons, you usually don’t care about any 
intermediate events like button-is-being-pressed and 
button-is-being-released. What you want to say to 
the button is, “I don’t care how the user plays with 
the button, how long they hold the mouse over it, 
how many times they change their mind and roll off 
before letting go, etc. Just tell me when the user 
means business! In other words, don’t call me 
unless the user clicks in a way that indicates he wants 
the darn button to do what it says it’ll do!” 
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First, the button needs to know 
that we care. 


tte button, | care about 
© ah happens to you. 


y > 


your code H 
ó O 
“ton 00> 


Ne 


@ The user clicked me! 


Second, the button needs a way 
to call us back when a button- 
clicked event occurs. 


RAIN 
POWER 


1. How could you tell a button object that you 
care about its events? That you're a concerned 
listener? 


2. How will the button call you back? Assume 
that there's no way for you to tell the button the 
name of your unique method (changelt()). So 
what else can we use to reassure the button that 
we have a specific method it can call when the 
event happens? [hint: think Pet] 
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event listeners 


If you care about the button’s events, 


implement an interface [UEIZE\ES 
aun) listening (a your events.” 


A listener interface is the bridge between the When you implement a 
listener (you) and event source (the button). listener interface, you 
The Swing GUI components are event sources. In Java terms, an give the button a way 
event source is an object that can turn user actions (click a mouse, to eal] you back. The 


type a key, close a window) into events. And like virtually everything e ° 

else in Java, an event is represented as an object. An object of interface 1§ where the 
some event class. If you scan through the java.awt.event package eal]-back method 1S 

in the API, you'll see a bunch of event classes (easy to spot—they declared. 

all have Event in the name). You'll find MouseEvent, KeyEvent, 


WindowEvent, ActionEvent, and several others. 


An event source (like a button) creates an event object when the 
user does something that matters (like click the button). Most of the 
code you write (and all the code in this book) will recewe events rather 
than create events. In other words, you'll spend most of your time as 


an event listener rather than an event source. 


Every event type has a matching listener interface. If you want 
MouseEvents, implement the MouseListener interface. Want 
WindowEvents? Implement WindowListener. You get the idea. And 
remember your interface rules—to implement an interface you declare 
that you implement it (class Dog implements Pet), which means you “ngiateCh angedi(temevert ev) 


must write implementation methods for every method in the interface. 


Some interfaces have more than one method because the event 
itself comes in different flavors. If you implement Mouse Listener, 
for example, you can get events for mousePressed, mouseReleased, 
mouseMoved, etc. Each of those mouse events has a separate 
method in the interface, even though they all take a MouseEvent. If 
you implement MouseListener, the mousePressed() method is called 
when the user (you guessed it) presses the mouse. And when the user 
lets go, the mouseReleased() method is called. So for mouse events, 


there’s only one event object, MouseEvent, but several different event 


methods, representing the different types of mouse events. 


466 chapter 14 


How the listener and source 
communicate: 


“Button, please add me to 
your list of listeners and call my 
actionPerformed() method when 
the user clicks you." 


aActionLis tene,, 
od Ce, 


x) 
n 
ac tionPerfo rmea tne 


The Listener 


If your class wants to know about a 
button’s ActionEvents, you implement 
the ActionListener interface. The button 
needs to know you're interested, so 
you register with the button by calling 
its addActionListener(this) and passing an 
ActionListener reference to it. In our first 
example, you are the ActionListener so you 


8 


pass this, but it's more common to create 

a specific class to do listen to events. The 
button needs a way to call you back when the 
event happens, so it calls the method in the 
listener interface. As an ActionListener, you 
must implement the interface’s sole method, 
actionPerformed(). The compiler guarantees it. 


“OK, you're an ActionListener, 
so I know how to call you back 
when there's an event—TI'll call 
the actionPerformed() method 


getting gui 


that I know you have." 


O 
© 
CEE] 
click me 
o ____________ ____ i+ 


The Event Source 


A button is a source of ActionEvents, 
so it has to know which objects are 
interested listeners. The button has an 
addActionListener() method to give 
interested objects (listeners) a way to 
tell the button they're interested. 


When the button’s addActionListener() 
runs (because a potential listener 
invoked it), the button takes the 
parameter (a reference to the listener 
object) and stores it in a list. When 

the user clicks the button, the 

button “fires” the event by calling the 
actionPerformed() method on each 
listener in the list. 


youarehere> 467 


getting events 


Getting a button’s ActionEvent 


@ Implement the ActionListener interface 


@ Register with the button (tell it you 
want to listen for events) 


@ Define the event-handling method (implement 
the actionPerformed() method from the 
ActionListener interface) 


he package 

import javax.swing.*; A new import statement, For rent ave m- ag says? 

import java.awt.event.*; <— that AetionListener an l Lechat e This h 
ne gleki? S 


glenn 
public class SimpleGui2 implements ActionListener {654 wns ne 


Aant: ko 
private JButton button; pejor isten 2 ks only 


public static void main(String[] args) { 


SimpleGui2 gui = new SimpleGui2(); 4 iede your ain gul elass 
usuðlIy m 


j m r . \di Nw. © 
} ae Nor TAE ae ike this; this is just kes 
ee way to get started. We'll see ae jae 
publ ic void go O { treating AetionListeners as we go throug 


JFrame frame = new JFrame (); 
button = new JButton ("click me"); button 
Ah the . Leners 
terest wit v ist ok liste om à class 
Register nad me 2 be an doyett 


~ 
@ — button.addActionListener (this) >< ihe button ass MU stener! 
/ Z graven 1° is Aetion 
yat implere” 

frame.getContentPane().add(button) ; 

frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE) ; skener mterfate $ 

frame.setSize(300, 300); nt the AetionL's 4 This is the 

frame.setVisible (true) ; Iw ar ormed() me man od! 

} attion 4 handling met? 


actual event- 


© 


public void actionPerformed (ActionEvent event) { 
button.setText ("I've been clicked!"); 


} The button calls thi 
} h is method to let k 
amen ve date Perens ar be 
) e . 
happened is adh a ga it here. Knowing the event 


or us. 
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Listeners, Sources, and Events 


For most of your stellar Java career, you will not be the source of 
events. 


(No matter how much you fancy yourself the center of your social 
universe.) 


Get used to it. Your job is to be a good listener. 


(Which, if you do it sincerely, can improve your social life.) 


As a listener, my job is to 
implement the interface, 

register with the button, and 
provide the event-handling. 


Listener GETS the 
event 


Hey, what about me? I'ma player too, you 
know! As an event object, I'm the argument 
to the event call-back method (from the 
interface), and my job is to carry data 
about the event back to the listener. 


getting gui 


As an event source, my job is to 
accept registrations (from listeners), 
get events from the user, and 
call the listener's event-handling 
method (when the user clicks me). 


Source SENDS 
the event 


Event object 
HOLDS DATA 
about the event 


n ent do” 
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event handling 


there are no 


Dumb Questions 


Q: 


A: You CAN. We just said that most of the time you'll 
be the receiver and not the originator of the event 

(at least in the early days of your brilliant Java career). 
Most of the events you might care about are “fired” by 
classes in the Java API, and all you have to do is be a 
listener for them. You might, however, design a program 
where you need a custom event, say, StockMarketEvent 
thrown when your stock market watcher app finds 
something it deems important. In that case, you'd make 
the StockWatcher object be an event source, and you'd 
do the same things a button (or any other source) 
does—make a listener interface for your custom event, 
provide a registration method (addStockListener()), and 
when somebody calls it, add the caller (a listener) to 

the list of listeners. Then, when a stock event happens, 
instantiate a StockEvent object (another class you'll write) 
and send it to the listeners in your list by calling their 
stockChanged(StockEvent ev) method. And don't forget 
that for every event type there must be a matching listener 
interface (so you'll create a StockListener interface with a 
stockChanged() method). 


Why can’t I be a source of events? 


G harpen our pencil 
nl y 


generated by more than one widget. 


Widgets 


check box 
text field 


scrolling list 


button 


dialog box 


radio button 


menu item 
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Each of these widgets (user interface objects) is the 
source of one or more events. Match the widgets with 
the events they might cause. Some widgets might be a 
source of more than one event, and some events can be 


Event methods 


windowClosing() 
actionPerformed() 
itemStateChanged() 
mousePressed() 
keyTyped() 
mouseExited() 


focusGained() 


Q: | don’t see the importance of the event object 
that’s passed to the event call-back methods. If 
somebody calls my mousePressed method, what 
other info would I need? 


A: A lot of the time, for most designs, you don’t need 
the event object. It's nothing more than a little data carrier, 
to send along more info about the event. But sometimes 
you might need to query the event for specific details 
about the event. For example, if your mousePressed() 
method is called, you know the mouse was pressed. But 
what if you want to know exactly where the mouse was 
pressed? In other words, what if you want to know the 

X and Y screen coordinates for where the mouse was 
pressed? 


Or sometimes you might want to register the same listener 
with multiple objects. An on-screen calculator, for example, 
has 10 numeric keys, and since they all do the same thing, 
you might not want to make a separate listener for every 
single key. Instead, you might register a single listener with 
each of the 10 keys, and when you get an event (because 
your event call-back method is called), you can calla 
method on the event object to find out who the real event 
source was. In other words, which key sent this event. 


How do you KNOW if 
an object is an event 
source? 

Look in the API. 


OK. Look for what? 


A method that starts with 
“sadd,” ends with “Listener,” 
and takes a listener inter- 
face argument. If you see: 


addKeyListener (KeyListener k) 


you know that a class 
with this method is a 
source of KeyEvents. 
There’s a naming pattern. 


—-+> Yours to solve. 
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Getting back to graphics... 


Now that we know a little about how events work (we'll learn more 
later), let’s get back to putting stuff on the screen. We’ll spend a few 
minutes playing with some fun ways to get graphic, before returning 
to event handling. 


Three ways to put things on your GUI: 


© Put widgets on a frame 
Add buttons, menus, radio buttons, etc. 


frame .getContentPane() .add (myButton) ; 


The javax.swing package has more than a dozen 


widget types. 
Number of Head 
. . First Java books 
@ Draw 2D graphics on a widget fistekeniy 
Use a graphics object to paint shapes. bought by coffee 


house baristas. 
graphics .fillOval (70,70,100,100) ; 


You can paint a lot more than boxes and circles; 
the Java2D APT is full of fun, sophisticated 


graphics methods. Pa 


a 
kiy James, 
ulations, . 
© Put a JPEG on a widget eh joo 
y x e Captive Model 
You can put your own images on a widget. and ihe Cnet INS Agent” 


graphics .drawImage (myPic, 10,10, this); 
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making a drawing panel 


Make your own drawing widget 


If you want to put your own graphics on the screen, your best bet is to 

make your own paintable widget. You plop that widget on the frame, 

just like a button or any other widget, but when it shows up, it will 

have your images on it. You can even make those images move, in an 

animation, or make the colors on the screen change every time you 

click a button. 

It’s a piece of cake. A Swing frame with a 


natan drawing PME! 
Make a subclass of JPanel and override one 


method, paintComponent(). (KE) 


All of your graphics code goes inside the paintComponent() method. 
Think of the paintComponent() method as the method called by 

the system to say, “Hey widget, time to paint yourself.” If you want 
to draw a circle, the paintComponent() method will have code for 
drawing a circle. When the frame holding your drawing panel is 
displayed, paintComponent() is called and your circle appears. If 

the user iconifies/minimizes the window, the JVM knows the frame 
needs “repair” when it gets de-iconified, so it calls paintComponent() 
again. Anytime the JVM thinks the display needs refreshing, your 
paintComponent() method will be called. 


One more thing, you never call this method yourself! The — 


argument to this method (a Graphics object) is the actual drawing 


canvas that gets slapped onto the real display. You can’t get this by 
yourself; it must be handed to you by the system. Yov'’ll see later, 
however, that you can ask the system to refresh the display (repaint()), 
which ultimately leads to pamtComponent() being called. 


grese: 
import javax.swing.*; g vod en ok doet 
JPanel, a bk ik e 


Make a abelass oÈ X a frame je 


hat You tan à 4 this one is You" 
— w n else Excey Aa 
any } mize wid 


7K You nee 
import java.awt.*; <— 


class MyDrawPanel extends JPanel { own tu thod. 
tre Bi |mportant Gra re The 
K N This is I NEVER all this > ourse ne 
public void paintComponent (Graphics g) { oe talls it and A Sat i se Grarhits, 
s 
g.setColor (Color.orange) ; D esh drawing Sue e Ak 
l l S tnat you may Fant o 
Imagine th at ‘g 
g.fillRect (20, 50, 100, 100); a it what en fo ra machine You're 
wha sha e to ` wr and then 
} ro where it ie daen ce for 
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Fun things to do in paintComponent() 


Let’s look at a few more things you can do in paintComponenti). 
The most fun, though, is when you start experimenting yourself: 
Try playing with the numbers, and check the API for class Graphics 


(later we'll see that there’s even more you can do besides what’s in the e- Note K wA 
es atk vou 
Graphics class). You filename XDE and pS 0 
7 ou ve ee code ins OF a 
Display a JPEG Ta w nes a ny).getlwa Y 
Wd e (“ ta zi\a- 


public void paintComponent (Graphics g) { rA \ el es 
oy 


Image image = new ImageIcon("catzilla. jpg") .getImage() ; 
—~— 


g.drawImage(image, 3, 4, this); 


for where the Pitture’s sop 


Ys “3 pixels fr 

top edge of the arel Panel and + pixels from die 
the widaet G, p, m bers are alwa 

sub¢lass), not the oo this Case Your JPanel 


rame. 


Paint a randomly colored circle 
on a black background 


public void paintComponent (Graphics g) { 


g.fillRect(0, 0, this.getWidth(), this.getHeight()); 


A i The first two args define the ( y) = i 
: tive pare f < drawing starts, so 0, O api vet er piaren, vene soit iy if ne 


Fill h y (the the top edge.” The oth i edge and O pixels $ 
th blat oe e other two args say, ‘Make th id : P j rom 
“elat tolor the panel bhis-wid tO) and make the height as vol sian cas wide as 
ee ee ee 
int green = random next Int (256) ; that ries we Can use java.util Random. | His how to use the 
int blue = random.nextInt (256) ; and this max oe ca ry returns a puider be Hi wy emad 
not Indlusive). In thi en O linelusive) 
Color randomColor = new Color (red, green, blue); n Tms Case 0-254, 
g.setColor (randomColor) ; 
g.fillOval(70, 70, 100, 100); K a hia make 
} olor b 
ASSing ; 
Start 70 pixels from the left, ny 
10 ibe the top, make it 10O represent th 
Pixels wide, and 100 pixels tall. Rep Vales e 
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drawing gradients with Graphics2D 


Behind every good Graphics reference 
is a GraphicsZD object 


The argument to paintComponent() is declared as type Graphics 
(java.awt.Graphics). 


public void paintComponent (Graphics g) { } Methods you can call ona 
——_—————=—<—<—JS 2 
Graphics reference: 
So the parameter “g” IS-A Graphics object. This means it could be a drawlmage() 
subclass of Graphics (because of polymorphism). And in fact, it zs. drawLine() 
The object referenced by the “g” parameter is drawPolygon 
actually an instance of the Graphics2D class. drawRect() 
Why do you care? Because there are things you can do with a drawOval() 
Graphics2D reference that you can’t do with a Graphics reference. fillRect() 
A Graphics2D object can do more than a Graphics object, and 
it really is a Graphics2D object lurking behind the Graphics fillRoundRect() 
reference. setColor() 


Remember your polymorphism. The compiler decides which 
methods you can call based on the reference type, not the object 


type. If you have a Dog object referenced by an Animal reference To cast the Graphics2D object to 
variable: a Graphics2D reference: 

Animal aS new- Dog(); Graphics2D g2d = (Graphics2D) g; 
You CANNOT say: 

a.bark(); 

Even though you know it’s really a Dog back there. The compiler Methods you can call on 

looks at “a,” sees that it’s of type Animal, and finds that there’s no a Graphics2D reference: 

remote control button for bark() in the Animal class. But you can B 

still get the object back to the Dog it really zs by saying: fillsDRect() 

Dog d = (Dog) a; draw3DRect() 

d.bark (); 


rotate() 


So the bottom line with the Graphics object is this: scale() 


If you need to use a method from the Graphics2D class, 


ce ia 


shear() 
you can’t use the paintComponent parameter (“g 


straight from the method. But you can cast it with a new transform() 
Graphics2D variable: setRenderingHints() 


Graphics2D g2d = (Graphics2D) g; 


(These are not complete method lists; 
check the API for more) 
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Because life’s too short to paint the i 
circle a solid color when there's a 
gradient blend waiting for you e 


. D abject ; 

: caphies> hits pu 
ja at ae gs a mere Geah 
mas 
abject 

public void paintComponent (Graphics g) { 


Graphics2D g2d = (Graphics2D) g; f 
” Cast it so we ĉan call something that 


Graphies2D has but Graphics doesn’t. 


GradientPaint gradient = new GradientPaint(70, 70, Color.blue, 150, 150, Color.orange) ; 


Start; f Starting D End; N Ending N 


This sets the, ED Pang 9 Color ng ag" Cl 
. v 
g2d.setPaint (gradient) ; 3 adient inst, irtual Paint 
ead of 5 sol brush boa 
ol 
g2d.fillOval(70, 70, 100, 100); id Color. 
} “All 
eans 
hod veally gi 
The fillOval ae e is loaded on YOU" 
1 with whatever "S Pg 
the oval W (ie, the gradient- 
paintbrush `€» 
public void paintComponent (Graphics g) { 
Graphics2D g2d = (Graphics2D) g; 
NC) 
3 e one ano 
Random random = new Random (); This is yst \ike = dom tolors for 
int red = random.nextInt (256) ; te? it ace tolors ok the 
int green = random.nextInt (256) ; ie start and “Ly ? 
int blue = random.nextInt (256); adient- Tey t. 
Color startColor = new Color (red, green, blue); 9 


red = random.nextInt (256); 

green = random.nextInt (256); 

blue = random.nextInt (256); 

Color endColor = new Color (red, green, blue); 


GradientPaint gradient = new GradientPaint (70, 70, startColor, 150, 150, endColor); 


g2d.setPaint (gradient) ; 
g2d.fillOval(70, 70, 100, 100); 
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m EVENTS 


events and graphics 


BULLET POINTS 


GRAPHICS 


To make a GUI, start with a window, usually a JFrame: 
JFrame frame = new JFrame(); 


You can add widgets (buttons, text fields, etc.) to the 
JFrame using: 
frame .getContentPane() .add (button) ; 


Unlike most other components, the JFrame doesn't let 
you add to it directly, so you must add to the JFrame’s 
content pane. 


To make the window (JFrame) display, you must give it a 
size and tell it to be visible: 

frame .setSize (300,300); 
frame.setVisible (true) ; 


To know when the user clicks a button (or takes some 
other action on the user interface) you need to listen for a 
GUI event. 


To listen for an event, you must register your interest with 
an event source. An event source is the thing (button, 
check box, etc.) that “fires” an event based on user 
interaction. 


The listener interface gives the event source a way to call 
you back, because the interface defines the method(s) 
the event source will call when an event happens. 


To register for events with a source, call the source’s 
registration method. Registration methods always take 
the form of add<EventType>Listener. To register for a 
button’s ActionEvents, for example, call: 

button. addActionListener (this); 


Implement the listener interface by implementing all 

of the interface’s event-handling methods. Put your 

event-handling code in the listener call-back method. For 

ActionEvents, the method is: 

public void actionPerformed (ActionEvent 

event) { 

button.setText ("you clicked!") ; 

} 

The event object passed into the event-handler method 

carries information about the event, including the source 

of the event. 
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You can draw 2D graphics directly on to a widget. 
You can draw a .gif or .jpeg directly on to a widget. 


To draw your own graphics (including a .gif or .jpeg), 
make a subclass of JPanel and override the paintCom- 
ponent() method. 


The paintComponent() method is called by the GUI 
system. YOU NEVER CALL IT YOURSELF. The argu- 
ment to paintComponent() is a Graphics object that 
gives you a surface to draw on, which will end up on 
the screen. You cannot construct that object yourself. 


Typical methods to call on a Graphics object (the paint- 
Component parameter) are: 

g.setColor (Color.blue) ; 

g.fillRect(20, 50, 100, 120); 


To draw a jpg, construct an Image using: 

Image image = new ImageIcon("catzilla. 
jpg") .getImage(); 

and draw the image using: 

g.drawImage (image,3,4,this) ; 


The object referenced by the Graphics parameter 
to paintComponent() is actually an instance of the 
Graphics2D class. The Graphics 2D class has a variety 


of methods including: 
fill3DRect(), draw3DRect(), rotate(), scale(), shear(), 
transform() 


To invoke the Graphics2D methods, you must cast the 
parameter from a Graphics object to a Graphics2D 
object: 

Graphics2D g2d = (Graphics2D) g; 
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We can get an event. 
We can paint graphics. 
But can we paint graphics when we get an event? 


Let’s hook up an event to a change in our drawing panel. We’ll make the circle change 
colors each time you click the button. Here’s how the program flows: 


Start the app 


The frame is built with the two widgets 
(your drawing panel and a button). A 
listener is created and registered with 
the button. Then the frame is displayed, 
and it just waits for the user to click. 


—_ The user clicks the button, and the 
button creates an event object and 
calls the listener's event handler. 


(3) The event handler calls repaint() on the 
frame. The system calls paintComponent() 
on the drawing panel. 


Voila! A new color is painted because 
paintComponent() runs again, filling the 
circle with a random color. 


Change colors 


you are here > 
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building a GUI frame 


Wait a minute...how 
do you put TWO 
things on a frame? 


GUI layouts: putting more than one 
widget on a frame 


We cover GUI layouts in the next chapter, but we’ll do a quickie 
lesson here to get you going. By default, a frame has five regions 
you can add to. You can add only one thing to each region of a 
frame, but don’t panic! That one thing might be a panel that holds 
three other things including a panel that holds two more things 
and...you get the idea. In fact, we were “cheating” when we added 
a button to the frame using: 


frame .getContentPane () .add (button) ; 


This isn’t real 
This 's the vetter (ont ‘oa fran ant (the segs tea 
mandate rane Aways se 
a hith region) À frame .getContentPane () .add (BorderLayout .CENTER, button); 
m al tre single 309 À on i 
Mpate oe hy od ee net Aa 
tne wae jon ond the widget to add bo thal vein 
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, harpen our pencil 
ary 


the frame. 


Given the pictures on page 477, write the 
code that adds the button and the panel to 


—> Yours to solve. 
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The circle changes color each time you 
click the button. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class SimpleGui3 implements ActionListener { 
private JFrame frame; 


public static void main(String[] args) { m 


Change colors } | 


SimpleGui3 gui = new SimpleGui3(); i e 
gui.go(); ~ utton is ™ of 
} cOUTH regon 
tre frame: 


public void go() { 
frame = new JFrame (); 
frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE) ; 


JButton button = new JButton("Change colors"); dg the liste 


button.addActionListener (this); < Ma ne button: 


MyDrawPanel drawPanel = new MyDrawPanel(); 
Add the two wi 

6 loitin ade 
frame.getContentPane().add(BorderLayout.SOUTH, button); / u ton and drawing anel) 
frame.getContentPane () .add (BorderLayout .CENTER, drawPanel); e two regions the 
frame.setSize(300, 300); rame. 
frame.setVisible (true); 


public void actionPerformed (ActionEvent event) { 
frame.repaint (); 


i When the user lieks, tell the frame 


À 1 \f. That means 
be vga aD is called on every 
Fidget in the frame. 


class MyDrawPanel extends JPanel { 


he draw 
Awin ? 
public void paintComponent (Graphics g) { method is i al $ PaintCompone t0 
// Code to fill the oval with a random color Clieks. ed every time á 


// See page 365 for the code 
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multiple listeners 


Let's try it with TWO buttons 


The south button will act as it does now, simply calling repaint on the 
frame. The second button (which we’ll stick in the east region) will change 
the text on a label. (A label is just text on the screen.) 


So now we need FOUR widgets 


a_i 


_ pn" mA 
east Laot Abe here 
west tenter iw 
Label will 
go here 
Drawing, panel goes 
in the center 
south 
Color—changing, 
button will go here 
eee 


And we need to get 
TWO events 


Uh-oh. 


Is that even possible? How do you 


I'm a label Change Label 


get two events when you have only 
one actionPerformed() method? 


This button changes the text 
on the opposite side. 


Change Circle 


This button changes the color 
the ¢ircle. 
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How do you get action events for two different buttons 
when each button needs to do something different? 


@ Option One 
Implement two actionPerformed() methods 


class MyGui implements ActionListener { 
// lots of code here and then: 


public void actionPerformed (ActionEvent event) { 

frame. repaint () ; FS But this is impossible! 
} a i 
public void actionPerformed (ActionEvent event) { 

label.setText ("That hurt!"); 


} 
} 


Flaw: You can’t! You can't implement the same method twice in a Java class. It won't compile. 
And even if you could, how would the event source know which of the two methods to call? 


Option Two 
Register the same listener with both buttons. 


class MyGui implements ActionListener { 
// declare a bunch of instance variables here 


public void go() { 
// build gui 
colorButton = new JButton(); 
labelButton = new JButton(); R ist : 
colorButton.addActionListener (this) ; €—~ egister the same listener 
labelButton.addActionListener (this) ; si with both buttons. 
// more gui code here ... 


} 


public void actionPerformed (ActionEvent event) { 
if (event.getSource() == colorButton) { i rect 
frame.repaint () ; Mm Query the even! a ce 
Petes i to find out whit d use 
label.setText ("That hurt!") ; actually fired it, ei i 
} that to decide wns 
} 
} 
Flaw: this does work, but in most cases it’s not very OO. One event handler 
doing many different things means that you have a single method doing many different things. 
If you need to change how one source is handled, you have to mess with everybody's event 
handler. Sometimes it is a good solution, but usually it hurts maintainability and extensibility. 


o- 
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How do you get action events for two different buttons 
when each button needs to do something different? 


Option Three 
Create two separate ActionListener classes 


class MyGui { 
private JFrame frame; 
private JLabel label; 


void gui() { 
// code to instantiate the two listeners and register one 
// with the color button and the other with the label button 


} 


class ColorButtonListener implements ActionListener { 
public void actionPerformed (ActionEvent event) { 
frame.repaint () ; 
} N Won't work! This class doesn t have a referente to 
the ‘frame’ variable of the My4ui class. 


class LabelButtonListener implements ActionListener { 
public void actionPerformed (ActionEvent event) { 
label.setText ("That hurt!"); 


} ag Problem 


! This elass has no reference to the variable “label.” 


Flaw: these classes won’t have access to the variables they need 
to act on, “frame” and “label.” You could fix it, but you'd have to give each of 
the listener classes a reference to the main GUI class, so that inside the actionPerformed() 
methods the listener could use the GUI class reference to access the variables of the GUI 
class. But that’s breaking encapsulation, so we'd probably need to make getter methods 
for the GUI widgets (getFrame(), getLabel(), etc.). And you'd probably need to adda 
constructor to the listener class so that you can pass the GUI reference to the listener at 
the time the listener is instantiated. And, well, it gets messier and more complicated. 


There has got to be a better way! 
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Wouldn't it be wonderful if 

you could have two different listener 
classes, but the listener classes could 
access the instance variables of the main 
GUI class, almost as if the listener 
classes belonged to the other class. Then 
you'd have the best of both worlds. Yeah, 
that would be dreamy. But it's just a 
fantasy... 
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inner classes 


Inner class to the rescue! 


You can have one class nested inside another. It’s easy. Just 
make sure that the definition for the inner class is inside the 
curly braces of the outer class. 


Simple inner class: 


An inner class can 
use all the methods 
and variables of the 
outer class, even the 
private ones. 


class MyOuterClass 


class MyInnerClass { 
void go() { 


The inner class gets 


to use those variables 


and methods just 
as if the methods 
An inner class gets a special pass to use the outer class’s stuff. Even the private and var iables were 
stuff’ And the inner class can use those private variables and methods of the declared within the 
outer class as if the variables and members were defined in the inner class. : la 
That’s what’s so handy about inner classes—they have most of the benefits Inner CLASS. 


of a normal class, but with special access rights. 


Inner class using an outer class variable 


class MyOuterClass { 
private int x; 


class MyInnerClass { 


void go() { Use ‘x’ as if it were a variable 


x = 42; eo ol the inner elass! 


} // close inner class 


} // close outer class 
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An inner class instance must be tied to 


an outer class instance* pr REEE 
< shares a special 
Remember, when we talk about an inner class accessing something in bond with an 


the outer class, we’re really talking about an instance of the inner class 
accessing something in an instance of the outer class. But which instance? 


outer object. & 


Can any arbitrary instance of the inner class access the methods and 


variables of any instance of the outer class? No! 


An inner object must be tied to a specific outer object on 


the heap. Make an instance of 


the outer class 
p 


A 
Uy Outer gow” 


Make an instance of 
the inner class, by 
using the instance 
of the outer class. 


A 
-oU 
Mnn OW 


The outer and inner objects 
are now intimately linked. 


; he heap 
ets on +4) / 
se two obje ed 
nie a spetia ond. The ine 
se the outers varia 
can v 
(and vice verse” 


*There’s an exception to this, for a very special case—an inner class defined within a static 
method. But we’re not going there, and you might go your entire Java life without ever 
encountering one of these. 
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inner class instances 


How to make an instance of an inner class 


If you instantiate an inner class from code within an outer class, the instance of 
the outer class is the one that the inner object will “bond” with. For example, if 
code within a method instantiates the inner class, the inner object will bond to the 
instance whose method is running. 


Code in an outer class can instantiate one of its own inner classes, in exactly the 
same way it instantiates any other class..new MyInner (). 


class MyOuter { The outer Class has $ private 


r : viable * 
private int x; <— instance V8 


K” Make an instanc, 


MyInner inner = new MyInner(); x 
inner Class. 


e of the 


public void doStuff() { 
inner.go(); 


<— Call a method on the 
i inner class. 


class MyInner { 
void go() { 


x = 42; g The method in the inner Class uses the oa 


è N n š 
} outer class instance variable “x, as it x 
} // close inner class belonged to the inner Class. 


} // close outer class 


Sidebar 


You can instantiate an inner instance from code running outside the outer class, but you 
have to use a special syntax. Chances are you'll go through your entire Java life and never 
need to make an inner class from outside, but just in case you're interested... 


MyInner 


class Foo { 
public static void main (String[] args) { 
MyOuter outerObj = new MyOuter() ; 


MyOuter.MyInner innerObj = outerObj.new MyInner () ; 
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Now we can get the two-button 
code working 
public class TwoButtons { €— 


private JFrame frame; 
private JLabel label; 


Muth better: the wat gul 
elass doesn t implemen 
ActionListener now: 


public static void main(String[] args) { I'm a labe 


TwoButtons gui = new TwoButtons() ; 
gui.go(); 


public void go() { 
frame = new JFrame(); 3 


getting gui 


Change Label 


Change Circle 


frame .setDefaultCloseOperation (JFrame .EXIT_ON_CLOSE) ; 


JButton labelButton = new JButton("Change Label") ; EN 
labelButton.addActionListener (new LabelListener () ) ; 


is) to the 


ana, (this? t 
ee . fice "ea stration 


a new instance © 


method, Meee listener elass- 


JButton colorButton = new JButton ("Change Circle"); "a the approp“ 


colorButton.addActionListener (new ColorListener ()); 


label = new JLabel("I’m a label"); 
MyDrawPanel drawPanel = new MyDrawPanel () ; 


frame .getContentPane() .add(BorderLayout.SOUTH, colorButton) ; 
frame .getContentPane() .add(BorderLayout.CENTER, drawPanel) ; 
frame .getContentPane() .add(BorderLayout .EAST, labelButton) ; 
frame .getContentPane() .add(BorderLayout.WEST, label); 


400); 
frame.setVisible (true) ; 


frame.setSize (500, 


} Now we a to have 


vonListeners 


phm 


class LabelListener implements ActionListener { 


TWO Àt 


public void actionPerformed (ActionEvent event) { 
label. setText ("Ouch!"); 


} SL hrer elass knows 
} about “label.” 


class ColorListener implements ActionListener { 
public void actionPerformed (ActionEvent event) { 


Ct Wa inner class gets to use th 
. nce variable, without ian 
erence to the outer ¢lass object. 


frame. repaint (); 


in a single elass 


TwoButtons 
object 


oter 


oes 


ColorListener 
object 


LabelListener™ 
object 
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inner classes 


HeadFirst: What makes inner classes important? 


Inner object: Where do I start? We give you a chance to 
implement the same interface more than once in a class. 
Remember, you can’t implement a method more than 
once in a normal Java class. But using inner classes, each 
inner class can implement the same interface, so you can 
have all these different implementations of the very same 
interface methods. 


HeadFirst: Why would you ever want to implement the 
same method twice? 


Inner object: Let’s revisit GUI event handlers. Think 
about it...1f you want three buttons to each have a 
different event behavior, then use three inner classes, all 
implementing ActionListener—which means each class 
gets to implement its own actionPerformed method. 


HeadFirst: So are event handlers the only reason to use 
inner classes? 


Inner object: Oh, gosh no. Event handlers are just an 
obvious example. Anytime you need a separate class but 
still want that class to behave as if it were part of another 
class, an inner class is the best—and sometimes only—way 
to do it. 


HeadFirst: I’m still confused here. If you want the inner 
class to behave like it belongs to the outer class, why have 

a separate class in the first place? Why wouldn’t the inner 
class code just be in the outer class in the first place? 


Inner object: I just gave you one scenario, where you 
need more than one implementation of an interface. But 
even when you're not using interfaces, you might need 
two different classes because those classes represent two 
different things. It’s good OO. 


HeadFirst: Whoa. Hold on here. I thought a big part of 
OO design is about reuse and maintenance. You know, the 
idea that if you have two separate classes, they can each be 
modified and used independently, as opposed to stuffing it 
all into one class yada yada yada. But with an inner class, 
youre still just working with one real class in the end, right? 
The enclosing class is the only one that’s reusable and 
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Java Exposed 


This week’s interview: 
Instance of an Inner Class 


separate from everybody else. Inner classes aren’t exactly 
reusable. In fact, I’ve heard them called “Reuseless— 
useless over and over again.” 


Inner object: Yes, it’s true that the inner class is not as 
reusable, in fact sometimes not reusable at all, because it’s 
intimately tied to the instance variables and methods of 
the outer class. But it— 


HeadFirst: —which only proves my point! If they’re not 
reusable, why bother with a separate class? I mean, other 
than the interface issue, which sounds like a workaround 
to me. 


Inner object: As I was saying, you need to think about 
IS-A and polymorphism. 


HeadFirst: OK. And I’m thinking about them because... 


Inner object: Because the outer and inner classes 
might need to pass different IS-A tests! Let’s start with the 
polymorphic GUI listener example. What’s the declared 
argument type for the button’s listener registration 
method? In other words, if you go to the API and check, 
what kind of thing (class or interface type) do you have to 
pass to the addActionListener() method? 


HeadFirst: You have to pass a listener. Something that 
implements a particular listener interface, in this case 
ActionListener. Yeah, we know all this. What’s your point? 


Inner object: My point is that polymorphically, you have 
a method that takes only one particular type. Something 
that passes the IS-A test for ActionListener. But—and 
here’s the big thing—what if your class needs to be 

an IS-A of something that’s a class type rather than an 
interface? 


HeadFirst: Wouldn’t you have your class just extend the 
class you need to be a part of? Isn’t that the whole point 
of how subclassing works? If B is a subclass of A, then 
anywhere an A is expected a B can be used. The whole 
pass-a-Dog-where-an-Animal-is-the-declared-type thing. 


Inner object: Yes! Bingo! So now what happens if you 
need to pass the IS-A test for two different classes? Classes 
that aren’t in the same inheritance hierarchy? 


HeadFirst: Oh, well you just...hmmm. I think I’m getting 
it. You can always implement more than one interface, but 
you can extend only one class. You can be only one kind of 
IS-A when it comes to class types. 


Inner object: Well done! Yes, you can’t be both a Dog 
and a Button. But if you’re a Dog that needs to some- 
times be a Button (in order to pass yourself to methods 
that take a Button), the Dog class (which extends Animal 
so it can’t extend Button) can have an inner class that acts 
on the Dog’s behalf as a Button, by extending Button, 
and thus wherever a Button is required, the Dog can 
pass his inner Button instead of himself: In other words, 
instead of saying x.takeButton(this), the Dog object calls 
x.takeButton(new MyInnerButton(). 


HeadFirst: Can I get a clear example? 


Inner object: Remember the drawing panel we used, 
where we made our own subclass of JPanel? Right now, 
that class is a separate, non-inner, class. And that’s fine, 
because the class doesn’t need special access to the instance 
variables of the main GUI. But what if it did? What if 
we’re doing an animation on that panel, and it’s getting its 
coordinates from the main application (say, based on some- 
thing the user does elsewhere in the GUI). In that case, if 
we make the drawing panel an inner class, the drawing 
panel class gets to be a subclass of JPanel, while the outer 
class is still free to be a subclass of something else. 


HeadFirst: Yes, I sec! And the drawing panel isn’t reus- 
able enough to be a separate class anyway, since what it’s 
actually painting is specific to this one GUI application. 


Inner object: Yes! You’ve got it! 


HeadFirst: Good. Then we can move on to the nature of 
the relationship between you and the outer instance. 


Inner object: What is it with you people? Not enough 
sordid gossip in a serious topic like polymorphism? 
HeadFirst: Hey, you have no idea how much the public is 
willing to pay for some good old tabloid dirt. So, someone 
creates you, and you become instantly bonded to the outer 
object, is that right? 

Inner object: Yes, that’s right. 


HeadFirst: What about the outer object? Can it be 
associated with any other inner objects? 


Inner object: So now we have it. This is what you really 
wanted. Yes, yes. My so-called “mate” can have as many 
inner objects as it wants. 
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HeadFirst: Is that like, serial monogamy? Or can it have 
them all at the same time? 


Inner object: All at the same time. There. Satisfied? 


HeadFirst: Well, it does make sense. And let’s not 
forget, it was you extolling the virtues of “multiple 
implementations of the same interface.” So it makes sense 
that if the outer class has three buttons, it would need 
three different inner classes (and thus three different inner 
class objects) to handle the events. 


Inner objects: You got it! 


HeadFirst: One more question. I’ve heard that when 
lambdas came along, you were almost put out of a job? 


Inner objects: Ouch, that really hurts! Okay, full 
disclosure, there are many cases for which a lambda is an 
easier to read, more concise way to do what I do. But inner 
classes have been around for a long time, and you’re sure 
to encounter us in older code. Plus, those pesky lambdas 
aren't better at everything.. 


He thinks he's got it made, having 
two inner class objects. But we have 

access to all his private data, so just 

imagine the damage we could do... 
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you are here > 


object lifecycle 


Can we take another look at that inner 
class code from a few pages back? It 
looks kind of clunky and hard to read. 


public void go() { 
frame = new JFrame(); 
frame.setDefaultCloseOperation (JUFrame.EXIT_ON_CLOSI! 


EJ 
~ 


3 —_<_ JButton labelButton = new JButton("Change Label"); 
l —— > labelButton.addActionListener (new LabelListener ()); 


JButton colorButton = new JButton ("Change Circle"); 


Lambdas to the rescue! colorButton.addActionListener (new ColorListener()); 
e 
(again) label = new JLabel ("I’m a label"); 


MyDrawPanel drawPanel = new MyDrawPanel (); 
He’s not wrong! One way to interpret the 


two highlighted lines of code would be: // code to add widgets, 


here 
frame.setSize(500, 400); 
frame.setVisible (true) ; 
“When the labelButton i í 
ActionListener gets an event, 
setText ("Ouch") ;” class LabelListener implements ActionListener { 


public void actionPerformed(ActionEvent event) { 
— +> _ label.setText ("Ouch!") ; 
Not only are those two ideas separated from } 
each other in the code, the inner class takes } 
FIVE lines of code to invoke the set'Text 


method. And of course, everything we’ve class ColorListener implements ActionListener { 
said about the labelButton code is also true public void actionPerformed(ActionEvent event) { 
about the colorButton code. frame.repaint (); 


Remember a few pages back we said that 
in order to implement the ActionListener 
interface you had provide code for its 
actionPerformed method? Hmmm...does 
that ring any bells? 
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getting gui 


ActionListener is a Functional Interface 


Remember that a lambda provides an implementation for a functional 
interface’s one and only abstract method. 


Since ActionListener is a functional interface, you can replace the inner classes we saw on the 
previous page with lambda expressions. 


public void go() { 
frame = new JFrame(); 
frame.setDefaultCloseOperation (JUFrame.EXIT_ON_CLOSE) ; 


JButton labelButton = new JButton("Change Label"); 
labelButton.addActionListener (event -> label.setText ("Ouch!") ) ; 


JButton colorButton = new JButton("Change Circle"); an 
colorButton.addActionListener (event -> frame.repaint ()); 


These two pi 
esi Pleces f 
~ highlighted Code ea 


label = new JLabel("I’m a label"); he lambdas that 
MyDrawPanel drawPanel = new MyDrawPanel (); replace the inner 
Classes. 


// code to add widgets, here 
frame.setSize(500, 400); 
frame.setVisible (true); 


class LabelListener implements ActionListener All of 4 
publ ®@, void actionPerformed (ActionEventmlevent) { a Not 2 j ar Class Code is gone! 
label. s@eText ("Ouch!"); ceded! Bye bye. f 


-> 


class ColorListeneafimplementš®®āctionListener { 
public void.@etionPerformed (ActienEvent event) { 
frame@Pepaint (); 


Lambdas, clearer and more concise 


Well, maybe not quite yet, but once you get used to reading lambdas, we’re 
pretty sure you'll agree that they make your code clearer. 
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inner classes 


Using an inner class for animation 


We saw why inner classes are handy for event listeners, because you get 
to implement the same event-handling method more than once. But 
now we'll look at how useful an inner class is when used as a subclass of 
something the outer class doesn’t extend. In other words, when the outer 
class and inner class are in different inheritance trees! 


Our goal is to make a simple animation, where the circle moves across 
the screen from the upper left down to the lower right. 


start Finish 


How simple animation works 


@ Paint an object at a particular x and y coordinate. 
g.fillOval (20,50,100,100) ; 
woes 


ba pixels from the left, 
50 pixels from the top 


© Repaint the object at a different x and y coordinate. 
———— 
g.fillOval (25,55,100,100) ; 
tos pixels from the left, 55 
pixels from the top 


(the object moved a little 
down and to the right) 


@ Repeat the previous step with changing x and y values 
for as long as the animation is supposed to continue. 
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thereareno 
Dumb Questions 


: Why are we learning 
about animation here? | doubt 
if I’m going to be making 
games. 


A: You might not be making 
games, but you might be 
creating simulations where 
things change over time to show 
the results of a process. Or you 
might be building a visualization 
tool that, for example, updates 

a graphic to show how much 
memory a program is using 

or to show you how much 

traffic is coming through 

your load-balancing server. 
Anything that needs to take a 
set of continuously changing 
numbers and translate them into 
something useful for getting 
information out of the numbers. 


Doesn't that all sound business- 
like? That’s just the “official 
justification,” of course. The real 
reason we're covering it here is 
just because it’s a simple way 
to demonstrate another use of 
inner classes. (And because we 
just like animation.) 
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What we really want is something like... 


tem invokes the 


class MyDrawPanel extends JPanel { | The sys 
Remember. method; YOu don 
public void paintComponent (Graphics g) { paintComponen 
g.setColor (Color.orange) ; have v: 
g.fillOval(x, y, 100, 100); 
l O is 
Each Lime paint omone pa K3 a 
i aled, the oval gets yain 
diferent location 


Ge Sharpen your pencil 
een your p 


But where do we get the new x and y 
coordinates? 


—— > Answers on page 494. 


And who calls repaint()? 
See if you can design a simple solution to get the ball to animate from the top left of the 
drawing panel down to the bottom right. Our answer is on the next page, so don’t turn 
this page until you're done! 

Big Huge Hint: make the drawing panel an inner class. 

Another Hint: don’t put any kind of repeat loop in the paintComponent() method. 

Write your ideas (or the code) here: 
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animation using an inner class 


The complete simple animation code 


import javax.swing.*; 
import java.awt.*; 
import Jjava.util.concurrent.TimeUnit; 


; iables im 
Make two instance p the x and 


private int xPos = 70; A gul elass, TOF 
ele. 
private int yPos = 70; — voor of the ewe 


public class SimpleAnimation { 


public static void main(String[] args) { 
SimpleAnimation gui = new SimpleAnimation() ; 
gui.go(); 

} 


public void go() { 
JFrame frame = new JFrame(); 


frame. setDefaultCloseOperation (JFrame .EXIT_ON_CLOSE) ; 


MyDrawPanel drawPanel = new MyDrawPanel () ; 


Nothi 
frame .getContentPane() .add(drawPanel) ; n9 new here. Mak . 
frame.setSize(300, 300); and pub them in the ra widgets 
frame.setVisible (true) ; . 
This is where for (int i = 0; i < 130; i++) { Repeat this 130 times. 
ieee xPos++; increment th 
ation s. i n e x and 
the yPost+; C Coordinates ; ko repaint itself (so we 
Tell the anel n the new loċation?: 
drawPanel. repaint () ; jo tan see he circle m 
try { 
TimeUnit .MILLISECONDS.sleep (50) ; 
} catch (Exception e) { mw Pause between repaints (otherwise it will 
e.printStackTrace () ; a quickly you won't SEE it move). Don’t i 
} perry: You weren't supposed to alre 
; h ady k 
} this. We'll look at this in Chapter 17. Y Know 
} 


class MyDrawPanel extends JPanel { 
public void paintComponent (Graphics g) { 


KS on g.setColor (Color.green) ; 
Now AY g.filloval(xPos, yPos, 40, 40); u 
rel } y se the Continually updated 
} coordinates of the outer dlas ai 
} : 
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Did it work? 

You might not have got the smooth animation that you 
expected. 

What did we do wrong? 

There’s one little flaw in the paintComponent() method. 


We need to erase what was already 
there! Or we might get trails. 


0099 


To fix it, all we have to do is fill in the entire panel with the 
background color, before painting the circle each time. The 
code below adds two lines at the start of the method: one to 
set the color to white (the background color of the drawing 
panel) and the other to fill the entire panel rectangle with that 
color. In English, the code below says, “Fill a rectangle start- 
ing at x and y of 0 (0 pixels from the left and 0 pixels from the 
top) and make it as wide and as high as the panel is currently. 


A 


public void paintComponent (Graphics g) { 
g.setColor (Color.white) ; 
g.fillRect(0, 0, this.getWidth(), this.getHeight() ) ; 


g.setColor (Color. green) ; 
g.fillOval(x, y, 40, 40); getWidth() and getHeight() 
} methods inherite d free fo 


‘ 
ra 
AN y 


Zet Sharpen your pencil (optional, just for Fun) 


getting gui 


Uh-oh. It didn’t 


move...it. Smeared. 


—-» Yours to solve. 


What changes would you make to the x and y coordinates to produce the animations below? 


(Assume the first example moves in 3-pixel increments. 


) 
1 x_+3 1 x 
Y +3 Y 


start finish start finish 


2 X 2 xX 
Yo Y 


start finish start finish 


3 X 3 x 
YY YY 


start finish start finish 
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Code Kitchen 


+ 


* 
x Code Kitchen 


beat one beat two beat three beat four ... 


Let’s make a music video. We'll use Java-generated random 
graphics that keep time with the music beats. 


Along the way we'll register (and listen for) a new kind of 
non-GUI event, triggered by the music itself. 


Remember, this part is all optional. But we think it’s good for you. 
And you'll like it. And you tan use it to impress people. 


(OK, sure, it might work only on people who are really easy to impress, 
but still...) 
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Listening for a non-GUl event 


OK, maybe not a music video, but we will make 

a program that draws random graphics on the 

screen with the beat of the music. In a nutshell, the 
program listens for the beat of the music and draws a 
random graphic rectangle with each beat. 


That brings up some new issues for us. So far, we’ve 
listened for only GUI events, but now we need to 
listen for a particular kind of MIDI event. Turns out, 
listening for a non-GUI event is just like listening 

for GUI events: you implement a listener interface, 
register the listener with an event source, and then sit 
back and wait for the event source to call your event- 
handler method (the method defined in the listener 
interface). 


The simplest way to listen for the beat of the music 
would be to register and listen for the actual MIDI 
events so that whenever the sequencer gets the event, 
our code will get it too and can draw the graphic. 
But...there’s a problem. A bug, actually, that won’t let 
us listen for the MIDI events we’re making (the ones 


for NOTE ON). 


So we have to do a little workaround. There is 
another type of MIDI event we can listen for, 

called a ControllerEvent. Our solution is to register 
for ControllerEvents and then make sure that 

for every NOTE ON event, there’s a matching 
ControllerEvent fired at the same “beat.” How do we 
make sure the ControllerEvent is fired at the same 
time? We add it to the track just like the other events! 
In other words, our music sequence goes like this: 


BEAT 1 - NOTE ON, CONTROLLER EVENT 
BEAT 2 - NOTE OFF 

BEAT 3 - NOTE ON, CONTROLLER EVENT 
BEAT 4 - NOTE OFF 

and so on. 


Before we dive into the full program, though, 

let’s make it a little easier to make and add MIDI 
messages/events since in this program, we’re gonna 
make a lot of them. 


getting gui 


What the music art program 
needs to do: 


@ Make a series of MIDI messages/ 
events to play random notes ona piano 
(or whatever instrument you choose). 


@ Register a listener for the events. 
@ Start the sequencer playing. 


@ Each time the listener's event 
handler method is called, draw a 
random rectangle on the drawing 
panel, and call repaint. 


We’ll build it in three iterations: 


@ Version One: Code that simplifies mak- 
ing and adding MIDI events, since we'll 
be making a lot of them. 


@ Version Two: Register and listen for 
the events, but without graphics. 
Prints a message at the command line 
with each beat. 


® Version Three: The real deal. Adds 
graphics to version two. 
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utility method for events 


An easier way to make 
messages/events 


Right now, making and adding messages and 

events to a track is tedious. For each message, we 
have to make the message instance (in this case, 
ShortMessage), call setMessage(), make a MidiEvent 
for the message, and add the event to the track. In 
the previous chapter’s code, we went through each 
step for every message. That means eight lines of 
code just to make a note play and then stop playing! 
Four lines to add a NOTE ON event, and four lines 
to add a NOTE OFF event. 


ShortMessage msgl = new ShortMessage () ; 
msgl1.setMessage (NOTE_ON, 1, 44, 100); 
MidiEvent noteOn = new MidiEvent(msgl, 1); 
track .add(noteOn) ; 


ShortMessage msg2 = new ShortMessage () ; 
msg2.setMessage (NOTE_OFF, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent (msg2, 
track .add(noteOf£) ; 


16); 


Things that have to happen for 
each event: 


@ Make a message instance 


ShortMessage msg = new ShortMessage() ; 


@ Call setMessage() with the instructions 


msg.setMessage (NOTE_ON, 1, instrument, 0); 


@® Make a MidiEvent instance for the message 


MidiEvent noteOn = new MidiEvent (msg, 1); 


(©) Add the event to the track 


track.add(noteOn) ; 


Let’s build a static utility method that 


The event tiek 
makes a message and returns a MidiEvent four arouments WHEN ti tick’ for 
The e IS message 
Lor the messa should happen 


GF eg 


public static MidiEvent makeEvent (int command, int channel, int one, int two, int tick) 
MidiEvent event = null; ; 

‘ Whoo! A method with five parameters. 

try { i 


ShortMessage msg = new ShortMessage(); 


Make the 
mes 
the method araa, 


msg.setMessage (command, channel, one, two); 


the event 


event = new MidiEvent (msg, tick); ) using 


} catch (Exception e) { 
e.printStackTrace () ; 
} 


return event; 


Return the event (a MidiEvent all 
loaded uP with the message). 
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Version One: using the new static 
makeEventl) method 


There’s no event handling or graphics here, just a sequence of 15 notes 
that go up the scale. The point of this code is simply to learn how to 
use our new makeEvent() method. The code for the next two versions is 
much smaller and simpler thanks to this method. 


lj 
import javax.sound.midi.*; = <—— Don’t forget the imports. 
import static javax.sound.midi.ShortMessage.*; 


public class MiniMusicPlayerl { 
public static void main(String[] args) { 
try { 


Sequencer sequencer = MidiSystem.getSequencer () ; a sequence” 


) 
sequencer. open () ; T make (and ore” 


Sequence seq = new Sequence (Sequence.PPQ, 4); €<~— Make 4 sequence 
Track track = seq.createTrack () ; 4— and a track. 


Make a bunch of events to make the a 
for (int i = 5; i < 61; i += 4) {2 909 uP (from piano note 5 to piano note bl). 
track.add(makeEvent (NOTE_ON, 1, i, 100, i)); Call owr- ee 
track.add(makeEvent (NOTE_LOFF, 1, i, 100, i + 2)); method to ans rina 
message 


and event; then add the result 


(the MidiEvent returned from 


sequencer. setSequence (seq) ; makeEvent()) to the track. 
sequencer. setTempoInBPM(220); y Start it ronnie hese are NOTE ON and NOTE 
sequencer.start () ; 3 pairs. 


catch (Exception ex) { 
ex.printStackTrace(); 


public static MidiEvent makeEvent (int cmd, int chnl, int one, int two, int tick) 
MidiEvent event = null; 
try { 


} 


ShortMessage msg = new ShortMessage(); 


msg.setMessage (cmd, chnl, one, two); 
event = new MidiEvent (msg, tick); 


catch (Exception e) { 


e.printStackTrace () ; 


return event; 
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controller events 


Version Two: registering and getting ControllerEvents 


import javax.sound.midi.*; 


import static javax.sound.midi.ShortMessage.*; 


public class MiniMusicPlayer2 { 
public static void main(String[] args) { 


MiniMusicPlayer2 mini = new MiniMusicPlayer2 () ; 


mini.go(); 


} 


. tec: 
for events with the sequen T 


, , i l kes the 
are ee LG gai veajsbration eso 
try { ; an int array © 
Sequencer sequencer = MidiSystem.getSequencer () ; listener Ah ConbrollerEvents you want, We 
sequencer.open () ; the lis ut one event i 


int[] eventsIWant = {127}; 


y — want care abo 


sequencer .addControllerEventListener (event -> System.out.printin("la"), eventsIWant) ; 


Sequence seq = new Sequence (Sequence.PPỌ, 


Track track = seq.createTrack () ; 


for (int i= 5; i < 60; i += 4) { 


track.add(makeEvent (NOTE_ON, 1, i, 100, i)); 


track.add(makeEvent (CONTROL_CHANGE, 1, 127, 0, i)); (CONTROL CHANGE) 


track.add(makeEvent (NOTE_OFF, 1, i, 
} 


sequencer. setSequence (seq) ; 
sequencer .setTempoInBPM (220) ; 
sequencer.start (); 

catch (Exception ex) { 
ex.printStackTrace () ; 


~ 


4); 


100, i+ 2)); 


n orint “la” 
i the event, we wp 

Eath time we ie We've a ‘ eet 

bo the Comma andle this Controller 


expression her 


Here’s how we pi 
| pick th — 
insert our OWN el Sai hares 
ith an arau t 

or event number #127. Th will 
NOTHING! We put it in i ed m 

: we ĉan get an event each time a 
a it Ma other words, its sole 

bus in Pe 

fh WE ioe listen Eo N 


¢ 2 . 
for NOTE ON/OFF events) Weve ney 
h is event happen at the SAME tiek as f 
e NOTE_ON. So when the NOTE_ON 


event happens, we'll kn bout it bee 
OUR event will fire at the ei ria 


public static MidiEvent makeEvent (int cmd, int chnl, int one, int two, int tick) { 


MidiEvent event = null; 
try { 
ShortMessage msg = new ShortMessage() ; 
msg.setMessage (cmd, chnl, one, two); 
event = new MidiEvent (msg, tick) ; 
catch (Exception e) { 
e.printStackTrace() ; 

} 

return event; 

} 

} 
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Code that’s different from the 
previous version is highlighted in 
gray (and we've moved the code 
out of the main() method into its 
own gol) method). 


Version Three: drawing graphics in time with the music 


This final version builds on Version Two by adding the GUI parts. We build a 
frame and add a drawing panel to it, and each time we get an event, we draw a 
new rectangle and repaint the screen. The only other change from Version ‘Two is 
that the notes play randomly as opposed to simply moving up the scale. 


The most important change to the code (besides building a simple GUI) is that we 
make the drawing panel implement the ControllerEventListener rather than the 
program itself. So when the drawing panel (an inner class) gets the event, it knows 
how to take care of itself by drawing the rectangle. 


Complete code for this version is on the next page. 


The drawing panel inner class: 


The drawing pane 


2 


class MyDrawPanel extends JPanel implements ControllerEventListener { 


| is a listener: 


getting gui 


private boolean msg = false; —— gas a flag to false, and we'll set it 
rue only when we get an event. 
public void controlChange(ShortMessage event) { han : 
The event t listener inte 


msg true; eK troll evEven Jon 
repaint () ; We t n Con . a expres 
O; c Jot an event, so we set th f| j sino a la bda ex 
} true and call repain l 0 e ag to wa a ee " and he Pane 


to listen to ControllerEvents 


(from the 
dle method Stee). 


public void paintComponent (Graphics g) { 


if (msg) { We have to use a flag beca 
int r = random.nextInt (250) ; things might tri ger OA Ai 
int gr = random.nextInt (250); we want paint ONLY when th i 
int b = random.nextInt (250); ControllerEvent. aae 


g.setColor (new Color (r, gr, b)); 


int height = random.nextInt (120) + 10; The rest is tode to generate 

int width = random.nextInt (120) + 10; a random éolor and paint a 
Semirandom rectangle. 

int xPos = random.nextInt (40) + 10; 

int yPos = random.nextInt (40) + 10; 


g.fillRect(xPos, yPos, width, height) ; 
msg = false; 
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MiniMusicPlayer3 code 


erp your pencil —+ Yours to solve. 
IN 


import javax.sound.midi.*; This is the complete code listing for Version 
import javax.swing.*; Three. It builds directly on Version Two. Try 
import java.awt.*; 


to annotate it yourself, without looking at the 
import java.util.Random; 


previous pages. 


import static javax.sound.midi.ShortMessage.*; 


public class MiniMusicPlayer3 { 
private MyDrawPanel panel; 
private Random random = new Random() ; 


public static void main(String[] args) { 
MiniMusicPlayer3 mini = new MiniMusicPlayer3() ; 
mini.go(); 


public void setUpGui() { 
JFrame frame = new JFrame ("My First Music Video"); 
panel = new MyDrawPanel () ; 
frame .setContentPane (panel); 
frame.setBounds (30, 30, 300, 300); 
frame.setVisible (true) ; 


public void go() { 
setUpGui () ; 


try { 
Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer .open () ; 
sequencer .addControllerEventListener (panel, new int[]{127}); 
Sequence seq = new Sequence (Sequence.PPQ, 4); 
Track track = seq.createTrack () ; 


int note; 

for (int i= 0; i < 60; i += 4) { 
note = random.nextInt (50) + 1; 
track.add(makeEvent (NOTE_ON, 1, note, 100, i)); 
track .add(makeEvent (CONTROL_CHANGE, 1, 127, 0, i)); 
track.add(makeEvent (NOTE_OFF, 1, note, 100, i + 2)); 


sequencer .setSequence (seq) ; 

sequencer.start (); 

sequencer .setTempoInBPM (120) ; 
} catch (Exception ex) { 

ex.printStackTrace () ; 
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public static MidiEvent makeEvent (int cmd, int chnl, 
MidiEvent event = null; 
try 4 
ShortMessage msg = new ShortMessage() ; 
msg.setMessage (cmd, chnl, one, two); 
event = new MidiEvent (msg, tick) ; 
} catch (Exception e) { 
e.printStackTrace() ; 
} 


return event; 


int two, 


class MyDrawPanel extends JPanel implements ControllerEventListener { 


private boolean msg = false; 


public void controlChange(ShortMessage event) { 
msg = true; 
repaint () ; 


public void paintComponent (Graphics g) { 
if (msg) { 
int r = random.nextInt (250); 
int gr = random.nextInt (250) ; 
int b = random.nextInt (250) ; 


g.setColor(new Color(r, gr, b)); 


int height = random.nextInt (120) + 10; 
int width = random.nextInt (120) + 10; 


int xPos random.nextInt (40) + 10; 
int yPos = random.nextInt (40) + 10; 


g.fillRect(xPos, yPos, width, height) ; 
msg = false; 


getting gui 


int tick) { 
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exercise: Who Am | 


504 


might show up! 


| got the whole GUI, in my hands. 
Every event type has one of these. 
The listener’s key method. 

This method gives JFrame its size. 


You add code to this method but never call it. 


When the user actually does something, it’s an 


Most of these are event sources. 


| carry data back to the listener. 


An addXxxListener( ) method says an object is an ; 


How a listener signs up. 

The method where all the graphics code goes. 
lm typically bound to an instance. 

The “g” in (Graphics g) is really of this class. 


The method that gets paintComponent( ) rolling. 


The package where most of the Swingers reside. 


chapter 14 


Tonight's attendees: 
Any of the charming personalities from this chapter just 


A bunch of Java hotshots, in full costume, are playing the party game “Who 
am |?” They give you a clue, and you try to guess who they are, based on 
what they say. Assume they always tell the truth about themselves. If they 
happen to say something that could be true for more than one guy, then 
write down all for whom that sentence applies. Fill in the blanks next to the 
sentence with the names of one or more attendees. 


————> Answers on page 507. 


getting gui 


BE the Compiler 


_ ‘The Java file on this page represents a 

H complete source file. Your job is to play 
< compiler and determine whether this file 

® will compile. If it won’t compile, how 

\ would you fix it, and if it does 

compile, what would it do? 


yy 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


class InnerButton { 
private JButton button; 


public static void main(String[] args) 
InnerButton gui = new InnerButton(); 
gui.go(); 


public void go() { 
JFrame frame = new JFrame(); 
frame.setDefaultCloseOperation ( 
JFrame .EXIT_ON_CLOSE); 


button = new JButton ("A"); 
button.addActionListener () ; 


frame.getContentPane() .add( 
BorderLayout.SOUTH, button); 

frame.setSize(200, 100); 

frame.setVisible (true); 


class ButtonListener extends ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (button.getText().equals("A")) { 
button.setText ("B"); 
} else { 
button.setText ("A"); 


——+ Answers on page 507. 
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puzzle: Pool Puzzle 


R Pool Puzzle 


Your job is to take code snippets from 
ZG 


the pool and place them into the blank 
lines in the code. You may use the 
same snippet more than once, 
and you won't need to use all the 
snippets. Your goal is to make a 
class that will compile and run 
and produce the output listed. 


Output 


The Amazing, Shrinking, Blue Rectangle. 
This program will produce a blue rectangle 
that will shrink and shrink and disappear into 
a field of white. 


Note: Each snippet 
from the pool can be 
used more than once! 


g.fillRect(x,y,x-500,y-250) 
g.fillRect(x,y,500-x*2,250-y*2) 
g fillRect(500-x*2,250-y*2,x,y) 
x++ — g.fillRect(0,0,250,500) 
y++  g.fillRect(0,0,500,250) 
g.setColor(blue) g 
g.setColor(white) draw 
( 
( 


i++ 


drawP.paint() 
draw.repaint() 
drawP.repaint() 


g.setColor(Color.blue) frame 
g.setColor(Color.white) panel 
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i++, y++ 
i++, y++, X++ 
Animate frame = new Animate() 


MyDrawP drawP = new MyDrawP() 
ContentPane drawP = new ContentPane() 


import javax.swing.*; 

java.awt.*; 

java.util.concurrent.TimeUnit; 

class Animate { 

1; 

1; 

public static void main(String[] args) { 
Animate gui = (ys 
gui.go(); 


import 
import 
public 
int x = 
int y = 


new Animate 


} 

public void go() { 
JFrame = new JFrame (); 

frame.setDefaultCloseOperation ( 


JFrame .EXIT_ON_CLOSBE) ; 


r 


————— .getContentPane ().add (drawP); 
F 

.setVisible (true); 
for (int i=0; i<124; ) 4 


try { 
TimeUnit.MILLISECONDS.sleep (50); 
} catch (Exception ex) { } 


} 


} 
class MyDrawP extends JPanel { 
public void paintComponent (Graphics 


drawP.setSize(500,270) 
frame.setSize(500,270) 
panel.setSize(500,270) 


———> Answers on page 508. 


Exercise Solutions 


Who Am J? (from page 504) 


| got the whole GUI, in my hands. 


Every event type has one of these. 


The listener’s key method. 


This method gives JFrame its size. 


You add code to this method but 
never call it. 


When the user actually does 
something, it’s an í 


Most of these are event sources. 
| carry data back to the listener. 


An addXxxListener( ) method 
says anobjectisan___. 


How a listener signs up. 


The method where all the 
graphics code goes. 


I’m typically bound to an instance. 


The “g” in (Graphics g) is 
really of this class. 


The method that gets 
paintComponent( ) rolling. 


The package where most of the 
Swingers reside. 


JFrame 
listener interface 
actionPerformed( ) 


setSize( ) 


paintComponent( ) 


event 
swing components 


event object 


event source 


addXxxListener( ) 


paintComponent( ) 


inner class 


Graphics2D 


repaint( ) 


javax.swing 


getting gui 


BE the Compiler (from page 505) 


Once this code 
is fixed, it will 

create a GUI with 
a button that 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
toggles between 
A and B when you 
click it. 


class InnerButton { 
private JButton button; 


public static void main(String[] args) { 
InnerButton gui = new InnerButton(); 
gui.go(); 

} 


public void go() { 
JFrame frame = new JFrame(); 
frame.setDefaultCloseOperation ( 
JFrame .EXIT_ON_CLOSE) ; 


The addActionListener( ) 
method takes a class that 


implements the ActionLis- 
tener interface. 


button = new JButton("A"); 
button.addActionListener (new ButtonListener()) ; 


frame.getContentPane() .add( 
BorderLayout.SOUTH, button); 

frame.setSize(200, 100); 

frame.setVisible (true); 


} 


class ButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (button.getText().equals("A")) { 
button.setText ("B"); 
} else { 
button.setText ("A"); 
} 
} ActionListener is an 
} interface; interfaces 
} are implemented, not 
extended. 
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puzzle answers 


lr, < 
oe Pos] Puz zle (from page 506) 


import javax.swing.*; 
import java.awt.*; 


import java.util.concurrent.TimeUnit; 


public class Animate { 

int x = 1; 

int y = 1; 

public static void main(String[] args) { 
Animate gui = new Animate (); 
gui.go(); 

} 

public void go() { 


The Amazing, Shrinking, Blue JFrame frame = new JFrame (); 


R le. f 
ectangie frame.setDefaultCloseOperation ( 


JFrame .EXIT_ON_CLOSE) ; 
MyDrawP drawP = new MyDrawP(); 
frame. getContentPane () .-add (drawP) ; 
frame.setSize(500, 270); 
frame. setVisible (true); 
for (int i = 0; i < 124; i++,yt++,x++ ) { 
X++; 
drawP.repaint(); 


try { 
TimeUnit .MILLISECONDS.sleep (50) ; 


} catch(Exception ex) { } 


} 
class MyDrawP extends JPanel { 
public void paintComponent (Graphics g) { 
g-setColor(Color.white); 
g.fillRect(0, 0, 500, 250); 
g-setColor(Color.blue); 
g.fillRect(x, y, 500-x*2, 250-y*2); 
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15 using swing 


Work on Your Swing 


Why won't the 
ball go where I want it to 
go (like, smack in Suzy Smith's 
face)? I've gotta learn to 


control it. 


Swing is easy. Unless you actually care where things end up on the screen. Swing code 
looks easy, but then you compile it, run it, look at it, and think, “hey, that’s not supposed to 

go there.” The thing that makes it easy to code is the thing that makes it hard to control—the 
Layout Manager. Layout Manager objects control the size and location of the widgets in a 
Java GUI. They do a ton of work on your behalf, but you won't always like the results. You want 
two buttons to be the same size, but they aren't. You want the text field to be three inches 
long, but it’s nine. Or one. And under the label instead of next to it. But with a little work, you 
can get layout managers to submit to your will. Learning a little Swing will give you a head start 
for most GUI programming you'll ever do. Wanna write an Android app? Working through this 


chapter will give you a head start. 
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components and containers 


Swing components 


Component is the more correct term for what we’ve been calling a widget. 
The things you put in a GUI. The things a user sees and interacts with. Text fields, 


buttons, scrollable lists, radio buttons, etc., are all components. In fact, they all A widget 18 technically 


extend javax.swing.JComponent. 
j omponent. 
Components can be nested E Swing eo ; y 
Almost everything you 


In Swing, virtually all components are capable of holding other components. K e 
In other words, you can stick just about anything into anything else. But most of can stick ma GUI 
the time, you'll add user interactive components such as buttons and lists into extends from 


background components (often called containers) such as frames and panels. 


Although it’s possible to put, say, a panel inside a button, that’s pretty weird and javax.swing. J Component. 


won't win you any usability awards. 


With the exception of JFrame, though, the distinction between interactive 
components and background components is artificial. A JPanel, for example, 

is usually used as a background for grouping other components, but even a 
JPanel can be interactive. Just as with other components, you can register for 
the JPanel’s events including mouse clicks and keystrokes. 


Four steps to making a GUI (review) 
@ Make a window (a JFrame) 


JFrame frame = new JFrame(); 


@ Make a component (button, text field, etc.) 
JButton button = new JButton ("click me"); 


@ Add the component to the frame 
frame.getContentPane() .add(BorderLayout .EAST, button); 


@ Display it (give it a size and make it visible) 
frame .setSize (300, 300) ; 
frame.setVisible (true) ; 


Put interactive components: Into background components: 
sn 
at JFrame JPanel 
| choose me Checkbox 
this is a text field JTextField 
— 
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Layout Managers 


A layout manager is a Java object associated with 

a particular component, almost always a background 
component. The layout manager controls the 
components contained within the component the 
layout manager is associated with. In other words, if 
a frame holds a panel, and the panel holds a button, 
the panel’s layout manager controls the size and 
placement of the button, while the frame’s layout 
manager controls the size and placement of the 
panel. The button, on the other hand, doesn’t 
need a layout manager because the button 

isn’t holding other components. 


If a panel holds five things, the size and 
location of the five things in the panel are all 
controlled by the panel’s layout manager. If 
those five things, in turn, hold other things (e.g., 
if any of those five things are panels or other 
containers that hold other things), then those 
other things are placed according to the layout 
manager of the thing holding them. 


When we say hold, we really mean add as in, a 
panel holds a button because the button was added to 
the panel using something like: 


myPanel.add (button) ; 


Layout managers come in several flavors, and each 
background component can have its own layout 
manager. Layout managers have their own policies 
to follow when building a layout. For example, one 
layout manager might insist that all components 

in a panel must be the same size, arranged in a 
grid, while another layout manager might let each 
component choose its own size but stack them 
vertically. Here’s an example of nested layouts: 


JPanel panelA = 


JPanel panelB = 


panelB.add(new JButton ("button 1")); 
panelB.add(new JButton ("button 2")); 
panelB.add(new JButton ("button 3")); 


panelA.add (pane1B) ; 


new JPanel (); 


new JPanel (); 


using swing 


As a layout manager, 
I'm in charge of the size 

and placement of your components. 

In this GUT, I'm the one who decided 

how big these buttons should be and 

where they are relative to each 


other and the frame. 


Panel A's la 
yout mana 
ama ak mia the size and Jer 
Panel BT and NEM Placement of Panel B, 
iv e 
Lo 
ton 


Panel B 


Panel A 


Panel A’s layout manager has NO 

say about the three bwttons ili 
tontrol is only one level—Panel A's Eye! 

manager Controls only the things added direct 

to Panel A, and does not tontrol an thin ' 

nested within those added A i 
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layout managers 


How does the layout manager decide? 


Different layout managers have different policies for arranging 
components (like, arrange in a grid, make them all the same size, stack 
them vertically, etc.), but the components being laid out do get at least 
some small say in the matter. In general, the process of laying out a 
background component looks something like this: 


A layout scenario 


@) Make a panel and add three buttons to it. 


@ The panel's layout manager asks each button how big 
that button prefers to be. 


@) The panel's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the buttons’ 
preferences. 


@ Add the panel to a frame. 


©) The frame's layout manager asks the panel how big the panel 
prefers to be. 


© The frame's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the panel's 
preferences. 


Different layout managers have different policies 


Some layout managers respect the size the component wants to be. 

If the button wants to be 30 pixels by 50 pixels, that’s what the layout 
manager allocates for that button. Other layout managers respect 

only part of the component’s preferred size. If the button wants to be 
30 pixels by 50 pixels, it'll be 30 pixels by however wide the button’s 
background panel is. Still other layout managers respect the preference 
of only the largest of the components being laid out, and the rest of the 
components in that panel are all made that same size. In some cases, the 
work of the layout manager can get very complex, but most of the time 
you can figure out what the layout manager will probably do, once you 
get to know that layout manager’s policies. 
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Let's see here...the 
first button wants to be 
30 pixels wide, the text field needs 
50, the frame is 200 pixels wide, and 
I'm supposed to arrange everything 
vertically... 


using swing 


The Big Three layout managers: 
border, flow, and box 


BorderLayout 


A BorderLayout manager divides a background 


component into five regions. You can add only one % 
one tomponen 


component per region to a background controlled 
oy 


by a BorderLayout manager. Components laid out per ve 
by this manager usually don't get to have their 
preferred size. BorderLayout is the default layout 


manager for a frame! 


FlowLayout 


A FlowLayout manager acts kind of like a word 


processor, except with components instead of { O Components ad 


d 
words. Each component is the size it wants to be, Om t=_ right, ed left 


pe wrapping to a 
and they're laid out left to right in the order that ai new line when needed 


they're added, with “word wrap" turned on. So 


when a component won't fit horizontally, it drops 
to the next “line” in the layout. FlowLayout is the 
default layout manager for a panel! 


BoxLayout 


. . . Ae 
A BoxLayout manager is like FlowLayout in that 
each component gets to have its own size, and ist 
the components are placed in the order in which G Components added P, 
they're added. But, unlike FlowLayout, a BoxLayout ko bottom, one iv salt 
manager can stack the components vertically (or Ou af it’s set vp vere y 
arrange them horizontally, but usually we're just A) 
concerned with vertically). It's like a FlowLayout Ei 
but instead of having automatic “component e 
wrapping,” you can insert a sort of “component 
return key" and force the components to start a 
=~ 
new line. 


youarehere> 513 


border layout 


——— BorderLayout cares 
about five regions: 
east, west, north, 
_\_—_] south, and center 


Let’s add a button to the east region: 


. ekage- 
import javax.swing.*; Gi BorderLayout is in the java.awt packag 


import java.awt.*; 


public class Buttoni { 
public static void main(String[] args) { 
Buttonl gui = new Buttonl1(); 
gui.go(); 
} 


public void go() { 
JFrame frame = new JFrame (); 
JButton button = new JButton ("click me"); 
frame .getContentPane() .add(BorderLayout .EAST, button); 
frame.setSize(200, 200); 
frame.setVisible (true) ; 


cpetify the al 


How did the BorderLayout manager come up with 
this size for the button? 


What are the factors the layout manager has to 
consider? 


Why isn't it wider or taller? 
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click me 


using swing 


Watch what happens when we give beak 
the button more characters... d only the S 
We chang? 


public void go() { 
JFrame frame = new JFrame(); 
JButton button = new JButton("click like you mean it"); 
frame.getContentPane().add(BorderLayout.EAST, button); 
frame.setSize(200, 200); 
frame.setVisible (true); 


First, I ask 
the button for its 
preferred size. 


I have a lot of words 
now, so I'd prefer to be 
60 pixels wide and 25 
pixels tall. 


(9) 
o 


C2 
Sutton oS 


Since 

it's in the east region 
of a border layout, I'll respect 
its preferred width. But I don't care 
how tall it wants to be; it's gonna be 
as tall as the frame, because that's 


my policy. 


Next time 
T'm goin’ with flow 
layout. Then I get 

EVERYTHING I want. 


O 
[0] 
The button gets 
ts eegerved t o 
click like you mean it 1 wath but no PÀ Ws 
a Ut ton oY 
erat: 
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border layout 


Let’s try a button in the NORTH region 


public void go() { 
JFrame frame = new JFrame(); 
JButton button = new JButton ("There is no spoon..."); 


frame.getContentPane() .add(BorderLayout -NORTH, button) ; 
frame.setSize(200, 200); 
frame.setVisible (true) ; 


¿ tall as it 
as Bie ae 
(EE) The button o Las wide 3 
& wants te 00 
the frame: 


Now let’s make the button ask to be taller 


How do we do that? The button is already as wide 
as it can ever be—as wide as the frame. But we 
can try to make it taller by giving it a bigger font. 


public void go() { 


the 
ANJ orte 
JFrame frame = new JFrame (); A bigger font r move spate 
JButton button = new JButton("Click This!"); Came to allots neigh: 
Font bigFont = new Font("serif", Font.BOLD, 28); W bu 


for the 
button.setFont (bigFont) ; 


frame.getContentPane().add(BorderLayout.NORTH, button); 
frame.setSize(200, 200); 
frame.setVisible (true); 


e =? | but now 
eer oC | ee “ath sta s the same, 
Click This! je Th niii aller: The north, 
Comm 
stretthe ed to ee weight: 
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using swing 


I think I'm getting it...if I'm in east or 
west, I get my preferred width, but the 
height is up to the layout manager. And 

if I'm in north or south, it's just the 
opposite—I get my preferred height, but 
not width. 


But what happens 


in the center region? 


O ——— 


Sutton 8 


The center region gets whatever’s left! 
(except in one special case we'll look at later) 


public void go() { 
JFrame frame = new JFrame (); 


JButton east = new JButton ("East"); 
JButton west = new JButton ("West"); 
JButton north = new JButton ("North"); 
JButton south = new JButton ("South"); 
JButton center = new JButton ("Center"); 


frame.getContentPane () .add (BorderLayout.EAST, east); 
frame.getContentPane () .add (BorderLayout.WEST, west); 
frame.getContentPane().add(BorderLayout.NORTH, north); 
frame.getContentPane () .add (BorderLayout .SOUTH, south); 
frame.getContentPane () .add (BorderLayout .CENTER, center); 


frame .setSize (300, 300); 
frame.setVisible (true); 


> 


Components i 

n the e 

patere spate is feo 
Ae He Frame dimensions 

x 300 in this Code). ci 


When you put i 
in the jon eda 


won be as tall 
would be if the ot 
and south regions were 


em pty. 


; and 
Components in the at ae 


west get their prefere 
ks in the north and 


l their preferred 


height: € 


300 pixels 
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flow layout 
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FlowLayout cares 


(JO | about the flow of the 


Om —Ə | Components: 


(=D left to right, top to bottom, in 
the order they were added. 


Let’s add a panel to the east region: 


A JPanel's layout manager is FlowLayout, by default. When we add a 
panel to a frame, the size and placement of the panel are still under 
the BorderLayout manager's control. But anything inside the panel 
(in other words, components added to the panel by calling pane1. 
add (aComponent) ) are under the panel's FlowLayout manager's 
control. We'll start by putting an empty panel in the frame's east 


region, and on the next pages we'll add things to the panel. ; 
The panel doesnt have ey oS 

an it, so tt doesn t ask tor 

width in the east region- 


import javax.swing.*; © 0 © 
import java.awt.*; 
public class Panell { 


public static void main(String[] args) { 
Panell gui = new Panell(); 
gui.go(); 

} 


public void go() { 
JFrame frame = new JFrame(); Make the panel gray so we ĉan see 
JPanel panel = new JPanel(); Me... it is on the — 
panel .setBackground (Color.darkGray) ; 
frame .getContentPane() .add(BorderLayout.EAST, panel); 
frame.setSize(200, 200); 
frame.setVisible (true) ; 
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using swing 


Let’s add a button to the panel 


public void go() { 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); th ganel-~ 
r e 

panel.setBackground (Color.darkGray) ; the button to 


had 
JButton button = new JButton ("shock me"); 
panel .add (button) ; 


frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize(200, 200); be ty \s 
rame. contro! 
frame.setVisible (true); and add the panel to the Tk panel's layout manager (flow) 
È 


j + 
d the Frames layou 
ee toda tontrols the panel: 


The panel expanded! 
And the button got its 


Preterred size in both 
dimensions, because the Panel 
uses tlow layout, and the 


button is o 
laot the ee the Panel 


and 


OK...I need to 
know how big the 
panel wants to be... 


I need 
to know how big the 
button wants to 


Based on my font 
size and the number of 
characters, I want to be 70 

pixels wide and 20 pixels tall. 


I have a button now, so 
my layout manager's gonna 
have to figure out how big 
I need to be... 


E A 
controls > 2 a controls } lr oÝ 


he] do’ 


The frame's The panel's 
BorderLayout manager FlowLayout manager 
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flow layout 


What happens if we add TWO buttons 
to the panel? 


public void go() { 

JFrame frame = new JFrame(); 

JPanel panel = new JPanel(); 

panel.setBackground(Color.darkGray) ; “ 
ke TWO button 
JButton button = new JButton ("shock me"); ¿— M? 
JButton buttonTwo = new JButton ("bliss"); kK 


panel.add (button) ; <— 


Add 
panel .add (buttonTwo) ; e BOTH to the Panel 


frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize(250, 200); 
frame.setVisible (true) ; 


what we wanted: what we got: 
eco 00o 
| Lkons 
We wart Oe A GE eath Prise 


f bliss] stacked on 


other: 


pencil 


iad your 
DN — Yours to solve. 


If the code above were modified to the code below, Draw what you 
what would the GUI look like? think the GUI would 


look like if you ran 


JButton button = new JButton("shock me"); the code to the left. 


JButton buttonTwo = new JButton("bliss"); 


JButton buttonThree = new JButton("huh?"); (Then try it!) 
panel.add (button); 
panel.add(buttonTwo) ; 
panel.add(buttontThree) ; 
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aoe 
CI BoxLayout to the rescue! 
n It keeps components 
Six stacked, even if there’s room 
c a to put them side by side. 


Unlike FlowLayout, BoxLayout can force a 
“new line” to make the components wrap to 
the next line, even if there’s room for them 
to fit horizontally. 


But now you'll have to change the panel's layout manager from the 
default FlowLayout to BoxLayout. 


public void go() { 
JFrame frame = new JFrame(); il anager to be a new 
JPanel panel = new JPanel(); Change the \ayou coed 
panel.setBackground(Color.darkGray) ; nstance of BoxLay 


panel.setLayout (new BoxLayout (panel, BoxLayout .Y_AXIS) ) ; 


JButton button = new JButton("shock me"); N Tne BoxLayout Constructo 

JButton buttonTwo = new JButton("bliss"); the Component it’s layin ina to know 
panel.add (button); and which axis to use ( J out Cie, the Panel) 
panel .add(buttonTwo) ; vertical stack). we use Y_AXIS for a 


frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize (250,200); 
frame.setVisible (true); 


; wer again, 
Notite how the a 4 pais both ear 
o * we ‘cam 
ab doesn told the 
ane oeta rankaliy; So oT only tre arget 
4 à enov) » 
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layout managers 


there, are_no 


Dumb Questions 


How come you can’t add directly to a frame the way 
you can to a panel? 


A: A JFrame is special because it’s where the rubber meets 
the road in making something appear on the screen. While 

all your Swing components are pure Java, a JFrame has to 
connect to the underlying OS in order to access the display. 
Think of the content pane as a 100% pure Java layer that sits 
on top of the JFrame. Or think of it as though JFrame is the 
window frame and the content pane is the...glass. You know, 
the window pane. And you can even swap the content pane 
with your own JPanel, to make your JPanel the frame's content 
pane, using: 


myFrame.setContentPane (myPanel) ; 


Q: Can I change the layout manager of the frame? What 
if | want the frame to use flow instead of border? 


A: The easiest way to do this is to make a panel, build the 
GUI the way you want in the panel, and then make that panel 
the frame's content pane using the code in the previous 
answer (rather than changing the default content pane). 


Q: What if I want a different preferred size? Is there a 
setSize() method for components? 


A: Yes, there is a setSize(), but the layout managers will 
ignore it. There's a distinction between the preferred size of 
the component and the size you want it to be. The preferred 
size is based on the size the component actually needs 

(the component makes that decision for itself). The layout 
manager calls the component's getPreferredSize() method, 
and that method doesn’t care if you've previously called 
setSize() on the component. 


Q: Can't I just put things where | want them? Can I turn 
the layout managers off? 


A: Yep. On a container-by-container basis, you can call 
setLayout (null), and then it’s up to you to hard-code 
the exact screen locations and dimensions. In the long run, 
though, it’s almost always easier to use layout managers. 
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-——— BULLET POINTS 


Layout managers control the size and 
location of components nested within other 
components. 


When you add a component to another 
component (sometimes referred to as a 
background component, but that’s not a 
technical distinction), the added component 
is controlled by the layout manager of the 
background component. 


A layout manager asks components for their 
preferred size, before making a decision about 
the layout. Depending on the layout manager’s 
policies, it might respect all, some, or none of 
the component’s wishes. 


The BorderLayout manager lets you add 

a component to one of five regions. You 
must specify the region when you add the 
component, using the following syntax: 
add (BorderLayout.EAST, panel); 


With BorderLayout, components in the north 
and south get their preferred height, but not 
width. Components in the east and west get 
their preferred width, but not height. The 
component in the center gets whatever is left 
over. 


FlowLayout places components left to right, 
top to bottom, in the order they were added, 
wrapping to a new line of components only 
when the components won't fit horizontally. 


FlowLayout gives components their preferred 
size in both dimensions. 


BoxLayout lets you align components stacked 
vertically, even if they could fit side-by-side. 
Like FlowLayout, BoxLayout uses the preferred 
size of the component in both dimensions. 
BorderLayout is the default layout manager 

for a frame's content pane; FlowLayout is the 
default for a panel. 


If you want a panel to use something other than 
flow, you have to call setLayout () onthe 
panel. 


using swing 


Playing with Swing components 


You’ve learned the basics of layout managers, so now let’s try out a few of the most 
common components: a text field, scrolling text area, checkbox, and list. We won’t show 
you the whole darn API for each of these, just a few highlights to get you started. If you 
do want to find out more, read Java Swing by Dave Wood, Marc Loy, and Robert Eckstein. 


JTextField m 
ooo 
Dog's first name: Frodo eT JTextField 
nad 
. \s- 
O means 10 columns vot ar of 
m re 
Constructors Ke defines prexer 
JTextField field = new JTextField(20) ; the text Field. 


JTextField field = new JTextField("Your name") ; 


How to use it 


@ Get text out of it 
System.out.println (field.getText() ) ; 


@) Put text in it 


field. setText ("whatever") ; 


field.setText("") ; 


N This clears the field 


@© Get an ActionEvent when the user ae register for ke events if 
presses return or enter ieee See ou about it every lime th E 
ey. 


field. addActionListener (myActionListener) ; 


@ Select/Highlight the text in the field 
field.selectAl1l1 () ; 


© Put the cursor back in the field (so the user 
can just start typing) 


field. requestFocus () ; 
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text area 


JTextArea 
eco 
Unlike JTextField, JTextArea can have more than one line of eee 
text. It takes a little configuration to make one, because it doesn’t 
come out of the box with scroll bars or line wrapping. To make a 
JTextArea scroll, you have to stick it in a JScrollPane. A JScrollPane 
is an object that really loves to scroll and will take care of the text 
area’s scrolling needs. 
—_— 
anes (sets 
10 means 10 Vines y s 
the referred haig 
Constructor (sets 
si 
JTextArea text = new JTextArea (10, 20); 10 means 10 e 
qpe preferred “' 
How to use it \\Pane and ive . Or Re 
v 
: ; Make 3 J Tak Ws gomg tes 
@ Make it have a vertical scrollbar only a tert grea Una 


JScrollPane scroller = new JScrollPane (text); 
text .setLineWrap (true); 


Tell the seroll 
i Pane to 
E€ Turn on line wrapping Jf a vertical scrollbar. 


scroller.setVerticalScrollBarPolicy (ScrollPaneConstants. E ee | 
scroller .setHorizontalScrollBarPolicy (ScrollPaneConstants . HORIZONTAL_SCROLLBAR_NEVER) ; 


e only 


panel .add (scroller); Important! You give the 4, 
—— Stroll Pane Constructo, e text area 


@ Replace the text that's in it 


text .setText ("Not all who are lost are wandering"); 


@ Append to the text that's in it 


text . append ("button clicked"); 
@ Select/highlight the text in the field 


text .selectAll() ; 


© Put the cursor back in the field (so the user 
can just start typing) 


text .requestFocus () ; 
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JTextArea example 


import javax.swing.*; 
import java.awt.*; 

import java.awt.event.*; button clicked 
button clicked 


button clicked 
public class TextAreal { button clicked 


public static void main(String[] args) { button clicked 


TextAreal gui = new TextAreal (); button ciickeg 
: button clicked 
gui.go(); button clicked 


} button clicked 


public void go() { 
JFrame frame = new JFrame(); 
JPanel panel = new JPanel(); 


st Click It 
JButton button = new JButton ("Just Click Ie"); WAL — — JustCiekit ü O 


JTextArea text = new JTextArea (10, 20); 

text .setLineWrap (true) ; aa | 

button.addActionListener(e -> text.append("button clicked \n")); nsert a new line so the 
a , 


words 9o ona F 
Lambda expression to implement the cach time the ie i 
button’s ActionListener. clicked. Otherwise, they'll 


JScrollPane scroller = new JScrollPane (text); run toge her. 
scroller.setVerticalScrol1l1BarPolicy (Scro11PaneConstants .VERTICAL_SCROLLBAR_ALWAYS) ; 
scroller .setHorizontalScroll1BarPolicy (Scro11PaneConstants . HORI ZONTAL_SCROLLBAR_NEVER) ; 


panel .add (scroller); 


frame.getContentPane().add(BorderLayout.CENTER, panel); 
frame.getContentPane().add(BorderLayout.SOUTH, button); 


frame.setSize(350, 300); 


frame.setVisible (true); butte = 


[clicked licked b 
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check box 


JCheckBox 
eoo 
O Goes to 11 


Constructor 
JCheckBox check = new JCheckBox ("Goes to 11"); 


How to use it 


@ Listen for an item event (when it's selected or deselected) 


check .addItemListener (this); 


®© Handle the event (and find out whether or not it's selected) 


public void itemStateChanged(ItemEvent e) { 
String onOrOff = "off"; 
if (check.isSelected()) { 
onoroff = "on"; 
} 
System.out.printin("Check box is " + onOrOff) ; 
} 


® Select or deselect it in code 


check .setSelected (true); 
check .setSelected (false); 
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there, are_no 


Dumb Questions 


| Aren't the layout managers 
just more trouble than they’re 
worth? If | have to go to all this 
trouble, I might as well just hard- 
code the size and coordinates for 
where everything should go. 


A: Getting the exact layout you 
want from a layout manager can be 


a challenge. But think about what 
the layout manager is really doing 
for you. Even the seemingly simple 
task of figuring out where things 
should go on the screen can be 
complex. For example, the layout 
manager takes care of keeping 

your components from overlapping 
one another. In other words, it 
knows how to manage the spacing 
between components (and between 
the edge of the frame). Sure, you 
can do that yourself, but what 
happens if you want components to 
be very tightly packed? You might 
get them placed just right, by hand, 
but that’s only good for your JVM! 


Why? Because the components 
can be slightly different from 
platform to platform, especially if 
they use the underlying platform's 
native “look and feel.” Subtle things 
like the bevel of the buttons can 
be different in such a way that 
components that line up neatly 

on one platform suddenly squish 
together on another. 


And we haven't even covered 

the really Big Thing that layout 
managers do. Think about what 
happens when the user resizes the 
window! Or your GUI is dynamic, 
where components come and 

go. If you had to keep track of 
re-laying out all the components 
every time there’s a change in the 
size or contents of a background 
component...yikes! 


using swing 


JList constructor 
takes an array of ‘ 
ied Bas have to be Strings m 
represe i : wg 
Constructor ntation will appear in the list. 
String[] listEntries = {"alpha", "beta", "gamma", "delta", 


"epsilon", "zeta", "eta", "theta "}; 
JList<String> list = new JList<>(listEntries) ; 


a JList is a generit class, so coe diamond operator 
ou tan declare what type 2 from Chapter Il. 


aaa a with JTextArea YO acne 


et |i add 
This 1s yst no give it the \ist), and ae 
JSevrallPane a (N the list) to the ? 


the stroll pane 


How to use it 


@ Make it have a vertical scrollbar 


JScrollPane scroller = new JScrollPane (list); 
scroller .setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLLBAR_ALWAYS ) ; 
scroller.setHorizontalScrollBarPolicy (Scrol1lPaneConstants . HORIZONTAL_SCROLLBAR_NEVER) ; 


panel .add (scroller); 


@ Set the number of lines to show before scrolling 


list .setVisibleRowCount (4) ; 


© Restrict the user to selecting only ONE thing at a time 


list .setSelect ionMode (ListSelectionModel .SINGLE_SELECTION) ; 


@ Register for list selection events 
list .addListSelectionListener (this); 


You'll get the event TWICE if you dont 


© Handle events (find out which thing in the list was selected) put in this if test. 


public void valueChanged(ListSelectionEvent e) { 
if ('e.getValueIsAdjusting()) { 


String selection = list.getSelectedvValue () ; getSelectedValuel) actual 
System.out .printi1n (selection) ; returns an Object. A it i t 
| ret - À list isn 
| limited to only String objects. 
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Code Kitchen 


* * 
X Code Kitchen 


% 
g é ida. F 
eee a Cyber BeatBox a 


Bass Drum Start 


Closed Hi-Hat ©) O C TETEE E E H a Stop 
Open Hi-Hat 

Acoustic Snare C) 0) | 
Crash Cymbal ) 

Hand Clap 

High Tom 

Hi Bongo 


Tempo Up 


Tempo Down 


Maracas 

Whistle 

Low Conga 

Cowbell 

Vibraslap 
Low-mid Tom 


High Agogo 


Open Hi Conga 


This part's optional. We're making the full BeatBox, GUI 
and all. In Chapter 16, Saving Objects, we'll learn how 
to save and restore drum patterns. Finally, in Chapter 17, 
Make a Connection, we'll turn the BeatBox into a working 
chat client. 
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using swing 


Making the BeatBox 


This is the full code listing for this version of the BeatBox, with buttons for starting, 
stopping, and changing the tempo. The code listing is complete, and fully annotated, but 
here’s the overview: 


@ 


Build a GUI that has 256 checkboxes (JCheckBox) that start out 
unchecked, 16 labels (JLabel) for the instrument names, and four 
buttons. 


Register an ActionListener for each of the four buttons. We don't 
need listeners for the individual checkboxes, because we aren't 
trying to change the pattern sound dynamically (i.e., as soon as the 
user checks a box). Instead, we wait until the user hits the “start” 
button, and then walk through all 256 checkboxes to get their state 
and make a MIDI track. 


Set up the MIDI system (you've done this before) including getting 

a Sequencer, making a Sequence, and creating a track. We are using 

a sequencer method, setLoopCount(), that allows you to specify 

how many times you want a sequence to loop. We're also using the 
sequence's tempo factor to adjust the tempo up or down, and maintain 
the new tempo from one iteration of the loop to the next. 


When the user hits “start,” the real action begins. The event-handling 
method for the “start” button calls the buildTrackAndStart() method. 
In that method, we walk through all 256 checkboxes (one row at a 
time, a single instrument across all 16 beats) to get their state, and 
then use the information to build a MIDI track (using the handy 
makeEvent() method we used in the previous chapter). Once the track 
is built, we start the sequencer, which keeps playing (because we're 
looping it) until the user hits “stop.” 
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BeatBox code 


import javax.sound.midi.*; 
import javax.swing.*; 
import java.awt.*; 

import java.util.ArrayList; 


import static javax.sound.midi.ShortMessage.*; 
public class BeatBox { 


private ArrayList<JCheckBox> checkboxList; We store the checkboxes in an ArrayList. 
private Sequencer sequencer; 


private Sequence sequence; These are the names of the instruments, as a Strin 
private Track track; O array, for building the GUI labels (on eath row). 
String[] instrumentNames = {"Bass Drum", "Closed Hi-Hat", 


"Open Hi-Hat", "Acoustic Snare", "Crash Cymbal", "Hand Clap", 
"High Tom", "Hi Bongo", "Maracas", "Whistle", "Low Conga", 
"Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", 
"Open Hi Conga"}; 
int[] instruments = {35, 42, 46, 38, 49, 39, 50, 60, 70, 72, 64, 56, 58, 47, 67, 63}; 


Th 
public static void main(String[] args) { Pes ese represent the actual drum “keys.” 


new BeatBox() .buildGUI () ; aon plas yi sane : 
ey on the piano is a differen 


ma So the number “25” is the key foe 
public void buildGur()) { e Dass drum, 42 is Closed Hi-Hat, ete. 
JFrame frame = new JFrame("Cyber BeatBox") ; 

frame .setDefaultCloseOperation (JFrame .EXIT_ON_CLOSE) ; 

BorderLayout layout = new BorderLayout () ; 

JPanel background = new JPanel (layout) ; 

background. setBorder (BorderFactory.createEmptyBorder(10, 10, 10, 10)); 


K An “empty border” ives us a margin 


Box buttonBox = new Box (BoxLayout.Y_AXIS) ; etween th d n 
€ edges ot the pan 
el and 


wher 
JButton start = new JButton ("Start"); rek, the Components are placed. 
start .addActionListener (e -> buildTrackAndStart ()); Y aesthetic. 
buttonBox.add (start) ; ; r these 
— Lambda expressions ave perfett tor ir 
ince when thes 
JButton stop = new JButton ("Stop"); event yeah ce want to do is call a 
stop.addActionListener(e -> sequencer.stop() ) ; are Pressea, a 


buttonBox.add (stop); ~- ~~m specific method. 


JButton upTempo = new JButton("Tempo Up"); 
upTempo.addActionListener(e -> changeTempo(1.03£) ) ; 
buttonBox.add(upTempo) ; 


) 
‘ we ve 
RA Tve default tengo Ma 
z ri 0 
JButton downTempo = new JButton ("Tempo Down"); mm adjusting +/ Y 
downTempo.addActionListener(e -> changeTempo (0.97£)); 
buttonBox .add (downTempo) ; 
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using swing 


This border. öh 

name helps th ach instrume 4 
Box nameBox = new Box (BoxLayout . Y_AXIS) ; Checkbox em line uP wit n 
for (String instrumentName : instrumentNames) { es. ith the 


JLabel instrumentLabel = new JLabel (instrumentName) ; 
instrumentLabel.setBorder (BorderFactory .createEmptyBorder (4, 1, 4, 1)); 
nameBox.add (instrument Label) ; 


background.add(BorderLayout .EAST, buttonBox) ; Still more gul setup tode. 
background. add (BorderLayout .WEST, nameBox) ; Nothing remarkable. 


frame .getContentPane () .add (background) ; khis one 
1s 
out manage . 
GridLayout grid = new GridLayout (16, 16); Another i th tomponents ma 
grid.setVgap (1); \ets you Y“ 
grid.setHgap (2); 


JPanel mainPanel = new JPanel (grid); 
background. add (BorderLayout .CENTER, mainPanel) ; 


checkboxList = new ArrayList<>(); 
for (int i = 0; i < 256; i++) { 
JCheckBox c = new JCheckBox (); 
c.setSelected (false); 


Make the checkboxes, set them to 


checkboxList .add (c); false (so they aren't checked), and 


" n À add them to the A Li 
mainPanel.add(c) ; the gul panel ray st AND to 


setUpMidi () ; 
frame.setBounds (50, 50, 300, 300); 


frame .pack () ; 
frame.setVisible (true); 


private void setUpMidi() { 


try { The usual 
sequencer = MidiSystem.getSequencer () ; ge ding nd : plone a 
sequencer .open () ; and the Tosa. Again fs equence, 
sequence = new Sequence (Sequence.PPQ, 4); » nothing special. 


track = sequence.createTrack () ; 
sequencer .setTempoInBPM (120) ; 


} catch (Exception e) { 
e.printStackTrace () ; 
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BeatBox code 


This is where it all happens! Where we 


; f 
turn checkbox state into MIDI ene \ement array to we De is 
dd them to the Track. Well make a |b-e em ; all |b beats: \f + SE that elemen 
paa e instrument, eee beat, the aor š pposed 
on jay on that beat Eng is NOT su 
private void buildTrackAndStart() { Wi be the bey. \f pat in 
int[] trackList; e lay on th beat put in 


fresh one. 
sequence .deleteTrack (track) ; ie vid of the old track, make a 


track = sequence.createTrack () 


ath of the lb ROWS (ie, Bass, Congo, ete.) 


for (int i = 0; i < 16; i++) { do this for e ee an 
trackList = new int[16]; Set the “key” that represents whi ent is 
(Bass Hi-Hat, ete). The instruments array 
A e aetual MIDI numbers Lor each instrument. 
Do this for each of the BEATS for this row: 
for (int j = 0; j < 16; j++) { ee 


JCheckBox jc = checkboxList.get(j + 16 * i); 


a ose ; i Is the checkbox at this beat selected? If yes, put 
} else { the key value in this slot in the array (the slot that 
trackList[j] = 0; represents this beat). Otherwise, the instrument is 
} NOT supposed to play at this beat, so set it to zero. 
} 
For this instrument, and for all 1 = 
makeTracks (trackList) ; ~~ make events and add them to the track. 
track .add(makeEvent (CONTROL_CHANGE, 1, 127, 0, 16)); 
} 
We always want to make sure that there IS an 
track. add (makeEvent (PROGRAM_CHANGE, 9, 1, 0, 15)); event at beat lb (it goes O to 15). Otherwise, the 
BeatBox might not go the full 16 beats before it 
starts over. 
try { 
sequencer. setSequence (sequence) ; 
sequencer .setLoopCount (sequencer .LOOP_CONTINUOUSLY); k~ Lets you spe ti fy the number 


sequencer. setTempoInBPM (120) ; of loop iterations, ov in this 
sequencer.start () ; j logi 
tase, Continuous looping. 
} catch (Exception e) { ae Now PLAY THE J Pins 
e.printStackTrace () ; THING! 
} 
} 
private void changeTempo (float tempoMultiplier) { The Tempo Factor scales the 
float tempoFactor = sequencer.getTempoFactor () ; sequencer s tempo by the factor 
sequencer.setTempoFactor (tempoFactor * tempoMultiplier) ; provided, slowing, the beat down or 
} speeding, it up. 
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using swing 


instrument at a time, for 


is m ts for one 
eooo we oe it might ae an intl i ee 
. . i 
drum, and eath index in he array wi f PN 


private void makeTracks (int[] list) { the key of that instrument or a A S 
for (int i = 0; i < 16; i++) { Lhe instrument isnt supposed to pla a e bak 
int key = list[i]; Otherwise, make an event and add 
if (key != 0) { 
track.add(makeEvent (NOTE_ON, 9, key, 100, i)); Make the NOTE ON and 
track.add(makeEvent (NOTE_OFF, 9, key, 100, i + 1)); NOTE OFF events, and 
} add them to the Track. 


} 
} 


public static MidiEvent makeEvent (int cmd, int chnl, int one, int two, int tick) { 
MidiEvent event = null; 


try { 
ShortMessage msg = new ShortMessage() ; This is the utilit 
msg.setMessage (cmd, chnl, one, two); Previous ths lity method from the 


event = new MidiEvent (msg, tick); 
catch (Exception e) { 
e.printStackTrace () ; 

} 


return event; 


pter’s Code Kitchen. 


othing new. 


~ 


} 
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exercise: Which Layout? 


Which code goes with 
which layout? 


Five of the six screens below were made from one 
of the code fragments on the opposite page. Match 
each of the five code fragments with the layout that 
fragment would produce. 


eee 
eee 
tesuji 
tesuji 
| tesuji 
E ® O 
` 
6) oco 
tesuji 
tesuji 


——> Answers on page 537. 
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Code Fragments 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
JButton buttonTwo = new JButton ("watari"); 
panel .add (button) ; 


frame .getContentPane() .add(BorderLayout .NORTH, buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.EAST, panel); 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 
JButton button = new JButton ("tesuji") ; 
JButton buttonTwo = new JButton ("watari"); 
panel .add (buttonTwo) ; 


frame .getContentPane() .add(BorderLayout.CENTER, button); 
frame .getContentPane() .add(BorderLayout.EAST, panel); 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 
JButton button = new JButton ("tesuji") ; 
JButton buttonTwo = new JButton ("watari"); 
panel .add (buttonTwo) ; 


frame .getContentPane() .add(BorderLayout .CENTER, button); 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 
JButton button = new JButton ("tesuji") ; 
JButton buttonTwo = new JButton ("watari"); 


frame .getContentPane() .add(BorderLayout .NORTH, panel); 


panel .add (buttonTwo) ; 


frame .getContentPane() .add(BorderLayout .CENTER, button); 


JFrame frame = new JFrame(); 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 
JButton button = new JButton ("tesuji") ; 
JButton buttonTwo = new JButton ("watari"); 


frame .getContentPane() .add(BorderLayout.SOUTH, panel); 


panel .add (buttonTwo) ; 


frame .getContentPane() .add(BorderLayout .NORTH, button); 


using swing 
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puzzle: crossword 


Down 


Across 

1. Artist's sandbox 
4. Border’s catchall 
5. Java look 

9. Generic waiter 
11. Ahappening 

12. Apply a widget 
15. JPanel's default 
16. Polymorphic test 
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17. Shake it, baby 
21. Lots to say 
23. Choose many 
25. Button’s pal 
26. Home of 


actionPerformed 


2. Swing’s dad 

3. Frame's purview 
5. Help’s home 

6. 
7 
8 
9 


More fun than text 


. Component slang 
. Romulin command 


. Arrange 


10. Border's top 


13. 
14. 
15. 
18. 
19. 
20. 
22. 
24. 


You can do it. 


Manager's rules 
Source’s behavior 
Border by default 
User's behavior 
Inner’s squeeze 
Backstage widget 
Classic Mac look 


Border’s right 


—————> Answers on page 538. 


using swing 


Exercise Solutions 


Which cade gees with which layout? 
(from pages 534-535) 


© e008 c) JFrame frame = new JFrame (); 
JPanel panel = new JPanel(); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
result JButton buttonTwo = new JButton ("watari"); 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout .CENTER, button); 


JFrame frame = new JFrame () ; 
© JPanel panel = new JPanel (); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
tesuji JButton buttonTwo = new JButton ("watari"); 
frame .getContentPane() .add(BorderLayout .NORTH, panel); 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout .CENTER, button); 


JFrame frame = new JFrame(); 
E) JPanel panel = new JPanel(); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
JButton buttonTwo = new JButton ("watari"); 
frame .getContentPane() .add(BorderLayout .SOUTH, panel); 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout .NORTH, button); 


(eee 
4 watari 


JFrame frame = new JFrame (); 
A) JPanel panel = new JPanel(); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
JButton buttonTwo = new JButton("watari") ; 
panel .add (button) ; 
frame .getContentPane() .add(BorderLayout .NORTH, buttonTwo) ; 
frame .getContentPane() .add(BorderLayout .EAST, panel); 


JFrame frame = new JFrame() ; 
© JPanel panel = new JPanel(); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
tesuji ] JButton buttonTwo = new JButton ("watari"); 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout .CENTER, button); 
frame .getContentPane() .add(BorderLayout .EAST, panel); 
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puzzle answers 


GUI-Cr ass (from page 536) 
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16 serialization and file I/O 


Saving Objects (and Text) 


If I have to read 
one more file full 
of data, I think I'll have to kill him. 
oO He knows I can save whole objects, but 
does he let me? NO, that would be 
too easy. Well, we'll just see how 
he feels after T... 


Objects can be flattened and inflated. Objects have state and behavior. Behavior lives in 
the class, but state lives within each individual object. So what happens when it’s time to save the state of an 
object? If you're writing a game, you're gonna need a Save/Restore Game feature. If you're writing an app 
that creates charts, you’re gonna need a Save/Open File feature. If your program needs to save state, you can 
do it the hard way, interrogating each object, then painstakingly writing the value of each instance variable 
to a file, in a format you create. Or, you can do it the easy OO way—you simply freeze-dry/flatten/persist/ 
dehydrate the object itself, and reconstitute/inflate/restore/rehydrate it to get it back. But you'll still have to 
do it the hard way sometimes, especially when the file your app saves has to be read by some other non-Java 
application, so we'll look at both in this chapter. And since all I/O operations are risky, we'll take a look at how 


to do even better exceptions handling. 
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saving objects 


Capture the beat 


You’ve made the perfect pattern. You want to save the pattern. You ase ee® id 7 9 o 
could grab a piece of paper and start scribbling it down, a e £ ‘ . 
but instead you hit the Save button (or choose Save gass Drum o S90 G A eka Si = . . . a 
from the File menu). Then you give it a name, picka aosa ttt = AO Ds OO Enoy as’ 
directory, and exhale knowing that your masterpiece  opentit = o0 gnoc e E r 
won't go out the window during a random computer acoustic 50% Pe ee ye as’ oe oo- 
h crash cymba? r e e e = e A (v ! 
crasu, wend PO zoc nao 
You have lots of options for how to save the state of High TOR , 3 ees = . Q 2 ' 0 
your Java program, and what you choose will probably  * Boi e` 400 2 = 0 9 mig 
depend on how you plan to use the saved state. Here are oe. ej P ae G . % -eot 


the options we’ll be looking at in this chapter. 


Low conga 


S u eaan 
If your data will be used by only the Ecce eater gen @ 82 


amid TOM 

Java program that generated it: nate s.” 
nig f { D 

oe . a ni cong? 
© Use serialization 


Write a file that holds flattened (serialized) objects. 
Then have your program read the serialized objects 
from the file and inflate them back into living, 
breathing, heap-inhabiting objects. 


If your data will be used by other programs: 


@ Write a plain-text file 


Write a file, with delimiters that other programs can parse. 
For example, a tab-delimited file that a spreadsheet or 
database application can use. 


These aren’t the only options, but if we had to pick only two approaches to doing 
I/O in Java, we’d probably pick these. Of course, you can save data in any format 
you choose. Instead of writing characters, for example, you can write your data as 
bytes. Or you can write out any kind of Java primitive as a Java primitive—there are 
methods to write ints, longs, booleans, etc. But regardless of the method you use, the 
fundamental I/O techniques are pretty much the same: write some data to something, 
and usually that something 1s either a file on disk or a stream coming from a network 
connection. Reading the data is the same process in reverse: read some data from 
either a file on disk or a network connection. Everything we talk about in this part is 
for times when you aren’t using an actual database. 
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Saving state 


Imagine you have a program, say, a fantasy adventure 
game, that takes more than one session to complete. 
As the game progresses, characters in the game 
become stronger, weaker, smarter, etc., and gather 
and use (and lose) weapons. You don’t want to start 
from scratch each time you launch the game—it took 
you forever to get your characters in top shape for a 
spectacular battle. So, you need a way to save the state 
of the characters, and a way to restore the state when 
you resume the game. And since you’re also the game 
programmer, you want the whole save and restore 
thing to be as easy (and foolproof) as possible. 


@ Option one 


Write the three serialized 
character objects to a file 


Create a file and write three serialized 
character objects. The file won't make 
sense if you try to read it as text: 


“IsrGameCharacter 
“%gé8MUIpowerLjava/lang/ 
String; [weaponst [Ljava/lang/ 
String;xp2tlfur [Ljava.lang.String;#“VA 
E{Gxptbowtswordtdustsq~ »tTrolluq” tb 
are handstbig axsq” xtMagicianugqg” tspe 
lstinvisibility 


@ Option two 
Write a plain-text file 


Create a file and write three lines of text, 
one per character, separating the pieces 
of state with commas: 


50,Elf,bow, sword,dust 
200,Troll,bare hands, big ax 
120,Magician,spells,invisibility 


GameCharacter 


int power 
String type 
Weapon|] weapons 


getWeapon() 
useWeapon() 
increasePower() 
I| more 


The sevialized fi 


u 


e th : 
reading in the fe ob 
ile. F, 

You éould id rok 
order! The 


while the Elf 


le is much 

'TS much easier (and Bes ‘bon 
ects from ser 
JEET s variable valu 


Ple, imagi 

ntally read ek s 

Ipe might become “dust” instead of « pis 
Omes 3 weapon... ec 
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Imagine 
have thr ng 


characters r Se 


(0) bj ec’ 


for humans 


ialization han £ 
es that were saved to 


you are here > 
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saving objects 


Writing a serialized object to a file 


Here are the steps for serializing (saving) an object. Don’t bother 
memorizing all this; we’ll go into more detail later in this chapter. 


n A £ 
le “MyGame-ser doesn T 
sig Ke be treated automatically. 
© Make a FileOutputStream f 


FileOutputStream fileStream = new FileOutputStream("MyGame.ser") ; 


Make a FileOut 


nows how to 


PutStream ob; 
onnet: tt (abject FileOutput-c tréan 


Create) a file. 


2) Make an ObjectOutputStream 


ObjectOutputStream os = new ObjectOutputStream (fileStream) ; 


ite obiects, 
Objet utp a EN se e Da Cle. |t nee 


but it cant directly, a actually called 


to be fed a “helpee | nother: 


“ehaining” one stream 


Q Write the object E the abiects eee by cena 
erial ter Three, an A 
haracte 
os .writeObject (characterOne) ; character Two, and Ly the file “MyGame-ser- 


os .writeObject (characterTwo) ; 
os .writeObject (characterThree) ; 


{hem in this order 


4) Close the ObjectOutputStream 
ETN 
Closing the stream at the top closes the ones 


underneath, s the F 
ile) will elese autonak Stream land the 


os.close(); 
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serialization and file I/O 


Data moves in streams from one place to another 


Connection 

Streams represent 

a connection to a 
Cm |. source or destination 

E E= a (file, network socket, 


re PRE-TRIP. 


sit i f. | SA ete.), while chain 

| JA | streams cant connect 
on their own and 
must be chained to a 
connection stream. 


The Java I/O API has connection streams, which represent connections to destinations and 
sources such as files or network sockets, and chain streams that work only if chained to other 
streams. 


Often, it takes at least two streams hooked together to do something useful—one to represent the 
connection and another to call methods on. Why two? Because connection streams are usually too 
low-level. FileOutputStream (a connection stream), for example, has methods for writing bytes. 
But we don’t want to write bytes! We want to write objects, so we need a higher-level chain stream. 


OK, then why not have just a single stream that does exactly what you want? One that lets you 
write objects but underneath converts them to bytes? Think good OO. Each class does one thing 
well. FileOutputStreams write bytes to a file. ObjectOutputStreams turn objects into data that 
can be written to a stream. So we make a FileOutputStream (a connection stream) that lets us 
write to a file, and we hook an ObjectOutputStream (a chain stream) on the end of it. When we 
call writeObject() on the ObjectOutputStream, the object gets pumped into the stream and then 
moves to the FileOutputStream where it ultimately gets written as bytes to a file. 


The ability to mix and match different combinations of connection and chain streams gives you 

tremendous flexibility! If you were forced to use only a single stream class, you'd be at the mercy 

of the API designers, hoping they’d thought of everything you might ever want to do. But with 

chaining, you can patch together your own custom chains. Destination 


01101001 


Object is flattened (serialized) Object is written as bytes to aioin 
— f - 011010010110111001 01 
is written to is chained to 
Object ObjectOutputStream FileOutputStream File 
(a chain stream) (a connection stream) 
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serialized objects 


What really happens to an object 
when it’s serialized? 


Gl) Object on the heap 2) Object serialized 


Objects on the heap have state— Serialized objects save the values 
the value of the object's instance of the instance variables so that 
variables. These values make one an identical instance (object) can be 


instance of a class different from 


brought back to life on the heap. 
another instance of the same class. 


00100101 The instance variable values 


nth i 
yer "T doles: —- for width and height ar 
aante OOO SN TT ae, 01000110 f saved to the file ci a 
RS 


'00.Ser, 
The values ave w. along with a littl 
out and pumped m the JVM ek L Ts 
the stream- the object (like what its 
tlass ype is). 


` oo.ser 
width height 


FileOutputStream fs = new FileOutputStream("foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (fs); 
os.writeObject (myFoo) ; 


Make a Fil 
Foo myFoo = new Foo(); e M aa ‘tes en iia 
myFoo. setWidth (37); ObjettOutputStrean i d aed eal i 
aap ere E ObjectOutput Stream to write the roam 
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serialization and file I/O 


But what exactly IS an objects state? 


What needs to be saved? 


Now it starts to get interesting. Easy enough to save the primitive values 

37 and 70. But what if an object has an instance variable that’s an object 
reference? What about an object that has five instance variables that are 
object references? What if those object instance variables themselves 


have instance variables? 


Think about it. What part of an object is potentially unique? Imagine 
what needs to be restored in order to get an object that’s identical to the 
one that was saved. It will have a different memory location, of course, 
but we don’t care about that. All we care about is that out there on the 
heap, we'll get an object that has the same state the object had when it 
was saved. 


i» 


What has to happen for the Car 
object to be saved in sucha 
way that it can be restored to its 
original state? 


Think of what—and how—you 
might need to save the Car. 


And what happens if an Engine 
object has a reference to a 
Carburetor? And what's inside the 
Tire[] array object? 


The Car object has two 
instance variables that 
reference two other 
objects. 


ine oe 


Engine Tire [] 


Cap ob\e™ 


What does it take to 
save a Car object? 
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serialized objects 


When an object is serialized, all the objects 
it refers to from instance variables are also : . 
serialized. And all the objects those objects entire object gr aph— 
refer to are serialized. And all the objects those all objects referenced 
objects refer to are serialized...and the best part 
is, it happens automatically! 


Serialization saves the 


by instance variables, 
starting with the 


Dog[] holds references to two Dog objects. Each Dog object holds object being serialized. 
a reference to a String and a Collar object. The String objects 
have a collection of characters, and the Collar objects have an int. 


This Kennel object has a reference to a Dog[] array object. The 


When you save the Kennel, all of this is saved! 
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serialization and file I/O 


If you want your class to be serializable, 


implement KALAA C 


The Serializable interface is known as a marker or tag interface, because the 

interface doesn’t have any methods to implement. Its sole purpose is to 

announce that the class implementing it is, well, serializable. In other words, 

objects of that type are saveable through the serialization mechanism. 

If any superclass of a class is serializable, the subclass is automatically 

serializable even if the subclass doesn’t explicitly declare “implements 

Serializable.” (‘This is how interfaces always work. If your superclass “IS-A’ 4 
Serializable, you are too.) eeM. implemen 


eN Wnatever E A Cail at cuntime- 
objectOutputStream.writeObject (mySquare) ; Cerializable 


J f 0) ) 
glizable ism the ) ava 10 atka e so 


import java.io.*; e Ser ou need à the import nt but aH Rie WM, 


No methods to impleme 


n 
zable, a 
lements Seriali s e” 
public class Square E { Rot OX to serialize o bjeċts ise 


private int width; Th 
private int height; E [hese two values will be saved. 
public Square(int width, int height) { 
this.width = width; 

this.height = height; 


} n 
à “foo.ser 
file name 
public static void main (String[] args) { Connett to ae it doesn t make â 
Square mySquare = new Square(50, 20); bac if aan aed “fo0.ser- 
. exceptions: w XE 
|/0 operations tan Throw eer ne 
try { a 
FileOutputStream fs = new FileOutputStream("foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (fs); 
os .writeObject (mySquare) ; iN Make an eet 
os.close(); Chained pi bje OutputStreg 
} catch (Exception ex) { Tell ; e Connection, stream 
ex.printStackTrace () ; it to write Lh b; 
} e object 
} 
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serialized objects 


Serialization is all or nothing. 


Can you imagine what would 
happen if some of the object’s 


state didn’t save correctly? Eeewww! That 


creeps me out just thinking 


import java.io.*; 


K S Pond objects tan be serialized. 


public class Pond implements Serializable { 


rivate uc uc. new uc r D ek 
variable, a 


public static void main(String[] args) { 
Pond myPond = new Pond(); 
try { 
FileOutputStream fs = new FileOutputStream("Pond.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (fs); 


os .writeObject (myPond) ; 
os.close(); 

} catch (Exception ex) { 
ex.printStackTrace () ; 


When you 


j ava pond 


% 


java. io 


Lhe Duck is not serializable! 
lt doesn’t implement Serializable, 


public class Duck { so when You try to serialize E 
// duck code here Pond Er it fails because the 
} Pond’s Duek instance variable 


can’t be saved. 
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try to vun the main | 


File Edit Window Help Regret 


_NotSerializar 
at Pond.main (o 


about it! Like, what if a Dog comes 
back with no weight. Or no ears. Or 
the collar comes back size 3 instead 
of 30. That just can't be allowed! 


Either the entire 
object graph is 
serialized correctly 
or serialization fails. 


You can’t serialize 
a Pond object if 
its Duck instance 
variable refuses to 
be serialized (by 
not implementing 
Serializable). 


n class Pond: 


zableException: Duck 
nd. java: 13) 
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It's hopeless, 
then? I'm completely 
screwed if the idiot who wrote the 


class for my instance variable forgot 
to make it Serializable? 


Mark an instance variable as transient 
if it can’t (or shouldn’t) be saved. 


If you want an instance variable to be skipped by the serialization 
process, mark the variable with the transient keyword. 


import Jjava.net.*; 
. 4 class Chat implements Serializable { 


» 


val i Se . . é 
ave this varie kig it —»transient String currentID; 


gor String userName; 


The userName variable J7 tere. code 


a be saved as part } 
< A ° the object’s state 
\ uring serialization. 
Pa If you have an instance variable that can’t be saved because it isn’t 
a ay serializable, you can mark that variable with the transient keyword 
and the serialization process will skip right over it. 


So why would a variable not be serializable? It could be that 

the class designer simply forgot to make the class implement 
Serializable. Or it might be because the object relies on runtime- 
specific information that simply can’t be saved. Although most 
things in the Java class libraries are serializable, you can’t save 
things like network connections, threads, or file objects. They’re all 
dependent on (and specific to) a particular runtime “experience.” 
In other words, they’re instantiated in a way that’s unique to a 
particular run of your program, on a particular platform, in a 
particular JVM. Once the program shuts down, there’s no way to 
bring those things back to life in any meaningful way; they have to 
be created from scratch each time. 
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there, are_no 


Dumb Questions 


Q: If serialization is so important, 
why isn’t it the default for all classes? 
Why doesn’t class Object implement 
Serializable, and then all subclasses 

will be automatically Serializable? 


z? Even though most classes will, 
and should, implement Serializable, 
you always have a choice. And you 
must make a conscious decision on 
a class-by-class basis, for each class 
you design, to “enable” serialization 
by implementing Serializable. 

First of all, if serialization were the 
default, how would you turn it off? 
Interfaces indicate functionality, not 

a lack of functionality, so the model 

of polymorphism wouldn't work 
correctly if you had to say, “implements 
NonSerializable’” to tell the world that 
you cannot be saved. 


+ Why would | ever write a class 
that wasn’t serializable? 


z There are very few reasons, but 
you might, for example, have a security 
issue where you don’t want a password 
object stored. Or you might have an 
object that makes no sense to save, 
because its key instance variables are 
themselves not serializable, so there’s 
no useful way for you to make your 
class serializable. 


Q: If a class I’m using isn’t 
serializable but there’s no good 
reason, can | subclass the “bad” class 
and make the subclass serializable? 
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Å: Yes! If the class itself is 
extendable (i.e., not final), you can 
make a serializable subclass and just 
substitute the subclass everywhere 
your code is expecting the superclass 
type. (Remember, polymorphism 
allows this.) That brings up another 
interesting issue: what does it mean if 
the superclass is not serializable? 


Q: You brought it up: what does it 
mean to have a serializable subclass 
of a non-serializable superclass? 


Å: First we have to look at what 
happens when a class is deserialized, 
(we'll talk about that on the next few 
pages). In a nutshell, when an object 
is deserialized and its superclass is not 
serializable, the superclass constructor 
will run just as though a new object of 
that type were being created. If there's 
no decent reason for a class to not 

be serializable, making a serializable 
subclass might be a good solution. 


+ Whoa! just realized 
something big...if you make a 
variable “transient,” this means 
the variable’s value is skipped over 
during serialization. Then what 
happens to it? We solve the problem 
of having a non-serializable instance 
variable by making the instance 
variable transient, but don’t we NEED 
that variable when the object is 
brought back to life? In other words, 
isn’t the whole point of serialization 
to preserve an object's state? 


A: Yes, this is an issue, but 
fortunately there’s a solution. If 
you serialize an object, a transient 


reference instance variable will be 
brought back as null, regardless of the 
value it had at the time it was saved. 
That means the entire object graph 
connected to that particular instance 
variable won't be saved. This could be 
bad, obviously, because you probably 
need a non-null value for that variable. 


You have two options: 


1. When the object is brought back, 
reinitialize that null instance variable 
back to some default state. This 

works if your deserialized object isn’t 
dependent on a particular value for 
that transient variable. In other words, 
it might be important that the Dog 
have a Collar, but perhaps all Collar 
objects are the same, so it doesn’t 
matter if you give the resurrected Dog 
a brand new Collar; nobody will know 
the difference. 


2. If the value of the transient variable 
does matter (say, if the color and design 
of the transient Collar are unique for 
each Dog), then you need to save the 
key values of the Collar and use them 
when the Dog is brought back to 
essentially re-create a brand new Collar 
that's identical to the original. 


| What happens if two objects in 
the object graph are the same object? 
Like, if you have two different Cat 
objects in the Kennel, but both Cats 
have a reference to the same Owner 
object. Does the Owner get saved 
twice? I’m hoping not. 


A: Excellent question! Serialization 
is smart enough to know when two 
objects in the graph are the same. In 
that case, only one of the objects is 
saved, and during deserialization, any 
references to that single object are 
restored. 


serialization and file I/O 


Deserialization: restoring an object deserialize 


serialized 


The whole point of serializing an object is so that you can restore it 
to its original state at some later date, in a different “run” of the JVM 
(which might not even be the same JVM that was running at the time 
the object was serialized). Deserialization is a lot like serialization in 


reverse. 


I£ the file “MyGameser’ doesn Ł 
© Make a FileInputStream í risk, youll get an extep ok 


FileInputStream fileStream = new FileInputStream("MyGame.ser") ; 


PutStrean ob; 
ect. The T: 
Connect to mK exi sling jilelmput Stream 
2) Make an ObjectInputStream 
ObjectInputStream os = new ObjectInputStream (fileStream) ; 
\ ts, 
Obie etlnputStream lets you na or 
but it can t diets Ta tonnection 
thame 
e ease a FilelnputStream 
3) Read the objects 
Object one = os.readObject (); Each time you say readObiect() Ł 
: . ) h 
Object two = os.readObject () ; object in the stream. So youl a ae e 


h ae 
Gijent tarse < os xeanobjeck (j; 2 T igs in which they were written. You'll 


objects thon n : you try to vead more 


O Cast the objects 


GameCharacter elf = (GameCharacter) one; 
GameCharacter troll = (GameCharacter) two; 
GameCharacter magician = (GameCharacter) three; The Phe nae Obieet 
Object! 's : 
Bie (ra ike with Arra La, = 
on have to Ga iE aealg i 
(8) Close the ObjectInputStream he type you know ' 
-cl : . 
erent Closing the stream at the top closes 4p 
ie rneath, so the FilelnputStream ( i na 
e) will Close automatically. ahehe 
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deserializing objects 


What happens during deserialization? 


When an object is deserialized, the JVM attempts to bring the 
object back to life by making a new object on the heap that has the 
same state the serialized object had at the time it was serialized. 
Well, except for the transient variables, which come back either null 


(for object references) or as default primitive values. 


01101001 
01101110 


01 
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is read by 


File 


chapter 16 


tan f 


Class is found and loaded, saved 
instance variables reassigned 


011010010110111001 


Object is read as bytes 


A| throw an 
T ws et ie load the 


upio 
elass: 


FileInputStream ObjectInputStream 


(a connection stream) (a chain stream) 


@ The object is read from the stream. 


The JVM determines (through info stored with 
the serialized object) the object's class type. 


The JVM attempts to find and load the ob- 
ject's class. If the JVM can't find and/or load 
the class, the JVM throws an exception and 
the deserialization fails. 


A new object is given space on the heap, but 
the serialized object's constructor does NOT 
run! Obviously, if the constructor ran, it would 
restore the state of the object to its original 
“new" state, and that's not what we want. We 
want the object to be restored to the state 

it had when it was serialized, not when it was 
first created. 


tthe VM 


e 
ia, 


Q 


Object 


(5) If the object has a non-serializable class 
somewhere up its inheritance tree, the 
constructor for that non-serializable class 
will run along with any constructors above 
that (even if they're serializable). Once the 
constructor chaining begins, you can't stop it, 
which means all superclasses, beginning with 
the first non-serializable one, will reinitialize 
their state. 


6) The object's instance variables are given the 
values from the serialized state. Transient 
variables are given a value of null for object 
references and defaults (0, false, etc.) for 
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primitives. 


there, are_no 


Dumb Questions 


: Why doesn’t the class get saved as part of the 
object? That way you don’t have the problem with 
whether the class can be found. 


A: Sure, they could have made serialization work that 
way. But what a tremendous waste and overhead. And 
while it might not be such a hardship when you're using 
serialization to write objects to a file on a local hard drive, 
serialization is also used to send objects over a network 
connection. If a class was bundled with each serialized 
(shippable) object, bandwidth would become a much larger 
problem than it already is. 


For objects serialized to ship over a network, though, there 
actually is a mechanism where the serialized object can be 
“stamped” with a URL for where its class can be found. This 
is used in Java's Remote Method Invocation (RMI) so that 


you can send a serialized object as part of, say, a method 
argument, and if the JVM receiving the call doesn’t have the 
class, it can use the URL to fetch the class from the network 
and load it, all automatically. You may see RMI used in the 
wild, although you may also see objects serialized to XML 
or JSON (or other human-readable formats) to send over a 
network. 


Q: What about static variables? Are they serialized? 


A: Nope. Remember, static means “one per class” not 
“one per object.’ Static variables are not saved, and when an 
object is deserialized, it will have whatever static variable its 
class currently has. The moral: don’t make serializable objects 
dependent on a dynamically changing static variable! It 
might not be the same when the object comes back. 
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Saving and restoring the game characters 


import java.io.*; 


public class GameSaverTest { 
public static void main(String[] args) { Make some characters. 
GameCharacter one = new GameCharacter(50, "Elf", 
new String[]{"bow", "sword", "dust"}); 
GameCharacter two = new GameCharacter(200, "Troll", 
new String[]{"bare hands", "big ax"}); 
GameCharacter three = new GameCharacter(120, "Magician", 


new String[]{"spells", "invisibility"}); 
// imagine code that does things with the characters that changes their state values 


try { 
ObjectOutputStream os = new ObjectOutputStream(new FileOutputStream("Game.ser") ) ; 
SSeS Sa, 
- ject (two); e Characters. 
os .writeObject (three) ; 
os.close(); 
} catch (IOException ex) { 
ex.printStackTrace(); 


Now read them back in from the file... 


try { 
ObjectInputStream is = new ObjectInputStream(new FileInputStream("Game.ser") ) ; 
GameCharacter oneRestore = (GameCharacter) is.readObject (); acters: 
GameCharacter twoRestore = (GameCharacter) is.readObject (); Restore the char 
GameCharacter threeRestore = (GameCharacter) is.readObject (); 
System.out.println("One's type: " + oneRestore.getType()); Check to see if it waked 
System.out.printin ("Two's type: " + twoRestore.getType()); 1 
System.out.printin ("Three's type: " + threeRestore.getType()); 


} catch (Exception ex) { 
ex.printStackTrace(); 


File Edit Window Help Resuscitate 
java GameSaverTest f 


One’s type: Elf 


Two’s type: Troll 


Three’s type: Magician 
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The GameCharacter class 


import java.io.*; 

import java.util.Arrays; Soak fo testing 
is is a basit elass jus 

This is Je on the last 


alization #00 
public class GameCharacter implements Serializable { the Serialization t 


ual game 
private final int power; page. We don t have an att r f 
ee Keli leave that to You 
private final String type; but we 
private final String[] weapons; experiment: 


public GameCharacter(int power, String type, String[] weapons) { 
this.power = power; 
this.type = type; 
this.weapons = weapons; 


public int getPower() { 
return power; 


public String getType() { 
return type; 


public String getWeapons() { 
return Arrays.toString (weapons) ; 
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Version ID: A big serialization gotcha 


Now you've seen that I/O in Java is actually pretty simple, especially if you 
stick to the most common connection/chain combinations. But there’s one 
issue you might really care about. 


Version Control is crucial! 


If you serialize an object, you must have the class in order to deserialize 
and use the object. OK, that’s obvious. But it might be less obvious what 
happens if you change the class in the meantime. Yikes. Imagine 
trying to bring back a Dog object when one of its instance variables 
(non-transient) has changed from a double to a String. That violates 
Java’s type-safe sensibilities in a Big Way. But that’s not the only change 
that might hurt compatibility. Think about the following: 


Changes to a class that can hurt deserialization: 
e Deleting an instance variable 

e Changing the declared type of an instance variable 

e Changing a non-transient instance variable to transient 

e Moving a class up or down the inheritance hierarchy 


e Changing a class (anywhere in the object graph) from Serializable to 
not Serializable (by removing ‘implements Serializable’ from a class 
declaration) 


e Changing an instance variable to static 


Changes to a class that are usually OK: 


e Adding new instance variables to the class (existing objects will 
deserialize with default values for the instance variables they didn’t 
have when they were serialized) 


e Adding classes to the inheritance tree 
e Removing classes from the inheritance tree 


e Changing the access level (public, private, etc.) of an instance 
variable has no effect on the ability of deserialization to assign a 
value to the variable 


e Changing an instance variable from transient to non-transient 
(previously serialized objects will simply have a default value for the 
previously transient variables) 
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© You write a Dog class. 


01010 1 


1010101 
10101010 
1001010101 


Dog.class 


© You serialize a Dog object 
using that class. 


Q <=. 


Dog obje . is \ 
Objet i with 


#128 


Dog.class 


You deserialize a Dog object 
using the changed class. 


101101 

101101 
101000010 
Sos sess 1010 10 0 
01010 1 


100001 1010 
0 00110101 


Obiect is 10110 10 

owed with Dog.class 

version — version as 
#118 


© Serialization fails!! 


The JVM says, “you can't 
teach an old Dog new code." 


Using the serialVersionVID 


Each time an object is serialized, the object (including every 
object in its graph) is “stamped” with a version ID number 
for the object’s class. The ID is called the serial VersionUID, 
and it’s computed based on information about the class 
structure. As an object is being deserialized, if the class has 
changed since the object was serialized, the class could have 
a different serialVersionUID, and deserialization will fail! 
But you can control this. 


If you think there is ANY possibility that 
your class might evolve, put a serial version 
ID in your class. 


When Java tries to deserialize an object, it compares the 
serialized object’s serialVersionUID with that of the class 
the JVM is using for deserializing the object. For example, 
if a Dog instance was serialized with an ID of, say 23 

(in reality a serialVersionUID is much longer), when the 
JVM deserializes the Dog object, it will first compare 

the Dog object serial VersionUID with the Dog class 
serialVersionUID. If the two numbers don’t match, the 
JVM assumes the class is not compatible with the previously 
serialized object, and you'll get an exception during 
deserialization. 


So, the solution is to put a serialVersionUID in your class, 
and then as the class evolves, the serialVersionUID will 
remain the same and the JVM will say, “OK, cool, the class 
is compatible with this serialized object,” even though the 
class has actually changed. 


This works only if you’re careful with your class changes! In 
other words, you are taking responsibility for any issues that 
come up when an older object is brought back to life with a 
newer class. 


To get a serialVersionUID for a class, use the serialver tool 
that ships with your Java development kit. 


File Edit Window Help serialKiller 


% serialver Dog 


Dog: static final long 
serialVersionUID = 
-5849794470654667210L; 
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When you think your class 
might evolve after someone has 
serialized objects from it... 


© Use the serialver command-line tool 
to get the version ID for your class. 


File Edit Window Help serialKiller 


% serialver Dog 


Dog: static final long 


serialVersionUID = 
-5849794470654667210L; 


K Based on the version of 


Java you're using, this value 
might be different. 


© Paste the output into your class. 
public class Dog { 


static final long serialVersionUID = 
—5849794470654667210L; 


private String name; 
private int size; 


// method code here 


© Be sure that when you make changes to 
the class, you take responsibility in your 
code for the consequences of the changes 
you made to the class! For example, be 
sure that your new Dog class can deal with 
an old Dog being deserialized with default 
values for instance variables added to the 
class after the Dog was serialized. 
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Object Serialization 


BULLET POINTS 


You can save an object's state by serializing the object. 

To serialize an object, you need an ObjectOutputStream (from the java.io 
package). 

Streams are either connection streams or chain streams. 


Connection streams can represent a connection to a source or 
destination, typically a file, network socket connection, or the console. 


Chain streams cannot connect to a source or destination and must be 
chained to a connection (or other) stream. 


To serialize an object to a file, make a FileOutputStream and chain it into 
an ObjectOutputStream. 


To serialize an object, call writeObject(theObject) on the 
ObjectOutputStream. You do not need to call methods on the 
FileOutputStream. 


To be serialized, an object must implement the Serializable interface. 
If a superclass of the class implements Serializable, the subclass will 
automatically be serializable even if it does not specifically declare 
implements Serializable. 


When an object is serialized, its entire object graph is serialized. That 
means any objects referenced by the serialized object’s instance 
variables are serialized, and any objects referenced by those objects... 
and so on. 


If any object in the graph is not serializable, an exception will be thrown at 
runtime, unless the instance variable referring to the object is skipped. 


Mark an instance variable with the transient keyword if you want 
serialization to skip that variable. The variable will be restored as null (for 
object references) or default values (for primitives). 


During deserialization, the class of all objects in the graph must be 
available to the JVM. 


You read objects in (using readObject()) in the order in which they were 
originally written. 


The return type of readObject() is type Object, so deserialized objects 
must be cast to their real type. 


Static variables are not serialized! It doesn’t make sense to save a static 
variable value as part of a specific object’s state, since all objects of that 
type share only a single value—the one in the class. 

If a class that implements Serializable might change over time, put a 
static final long serialVersionUID on that class. This version ID should be 
changed when the serialized variables in that class change. 
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Writing a String to a Text File 


Saving objects, through serialization, is the easiest way to save and restore 


data between runnings of a Java program. But sometimes you need to save What the game character data 
data to a plain old text file. Imagine your Java program has to write data to might look like if you wrote it 
a simple text file that some other (perhaps non-Java) program needs to read. out as a human-readable text file. 


You might, for example, have a servlet (Java code running within your web 
server) that takes form data the user typed into a browser and writes it to a 
text file that somebody else loads into a spreadsheet for analysis. 


50,Elf,bow,sword,dust 
200,Troll,bare hands,big ax 
120,Magician,spells,invisibility 


Writing text data (a String, actually) is similar to writing an object, except 
you write a String instead of an object, and you use something like a 
FileWriter instead of a FileOutputStream (and you don’t chain it to an 
ObjectOutputStream). 


To write a serialized object: 
objectOutputStream.writeObject (someObject) ; 


To write a String: 
fileWriter.write("My first String to save"); 


kage Lor FileWeiter: 
E We need the javaio cs 
import java.io.*; 
i i w ” goes rot 
class meitearaie { € the file Foote ae tk. 
public static void main(String[] args) { \ a FileWriter w 
enist) 


try { 
vi FileWriter writer = new FileWriter ("Foo.txt"); 


L tne W/O stuft keh. ! l The we 

ALL ne tye writer.write("hello foo!"); <— lhe writel) method tak 
4 be in 8 y an Shri es 
masi iing can neo a String. 

Every 


loExcertion:- writer.close(); Close it shea you're done! 
} catch (IOException ex) { 


ex.printStackTrace () ; 
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Text file example: e-Flasheards 


Remember those flashcards you used in school? Where you 
had a question on one side and the answer on the back? They 
aren't much help when you’re trying to understand something, 
but nothing beats ’em for raw drill-and-practice and rote 
memorization. When you have to burn in a fact. And they’re also 
great for trivia games. 


We’re going to make an electronic version that has 
three classes: 


1. QuizCardBuilder, a simple authoring tool for creating and 
saving a set of e-Flashcards. 


2. QuizCardPlayer, a playback engine that can load a 


flashcard set and play it for the user. QuizCard 
3. QuizCard, a simple class representing card data. We’ll walk QuizCard(q, a) 
through the code for the builder and the player, and have you 
make the QuizCard class yourself, using this: ————————>_ | question 
answer 
getQuestion() 
eee Quiz Card Builder getAnswer() 
| File 
Question: 
| Which university is featured in the | 
| film "Good Will Hunting"? eoo Quiz Card Player 


File 


Which university is featured in the 
film "Good Will Hunting"? 


Answer: 


M.I.T.| 


Next Card 


Show Answer 


— ae 


QuizCardBuilder QuizCardPlayer 
Has a File menu with a “Save” option for saving Has a File menu with a “Load" option for loading a 
the current set of cards to a text file. set of cards from a text file. 
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Quiz Card Builder (code outline) 


public class QuizCardBuilder { 
public void go() { Builds and displays the 
// build and display gui making and registering € 


GUI, including 


vent listeners: 


} 


) +o) . 
private void nextCard() { Call when user hits ‘Next = asi oa ii 
// add the current card to the list means the user wants to se 
// and clear the text areas the list and start a new 
} 
private void saveCard() { Call when user ¢h VR 
// bring up a file dialog box means the user spre ale Ki the File menu; 
// let the user name and save the set Nai list as a ‘set’ (like Qua ~ Cards in the 
exe ) uan 5 
} ollywood Trivia, Java Rules, w m Mechanies Set, 


private void clearCard() { 
// clear out the text areas 


Will need to clea 
ooses ‘Ney,’ fro 
} € next eard. 


r the SCreey, when th user 
: ie e! 
m the } ile menu Or moves 


private void saveFile (File file) { 
// iterate through the list of cards and write 
// each one out to a text file in a parseable way 
// (in other words, with clear separations between parts) 


Called by the SaveMenuListener; 
does the actual file writing. 


Java 1/0 to NIO to NIO.2 


The Java API has included I/O features since day one, you know, back in the last millennium. In 2002, 
Java 1.4 was released, and it included a new approach to I/O called “NIO,” short for non-blocking I/O. In 
2011, Java 7 was released, and it included big enhancements to NIO. This yet again newer approach to 
I/O was dubbed “NIO.2.”Why should you care? When you're writing new I/O, you should use the latest 


and greatest features. But you're almost certainly going to encounter older code that uses the NIO ap- 
proach. We want you to be covered for both situations, so in this chapter: 


+ We'll use original I/O for a while. 
+ Then we'll show some NIO.2. 


You'll see more I/O, NIO, and NIO.2 features in Chapter 17, Make a Connection, when we look at network 
connections. 
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Quiz Card Builder code 


import javax.swing.*; Reminder: For the next eight 
import java.awt.*; ‘tl b . 
import Java te.*) pages or so we e using 
import java.util.ArrayList; older-style 1/0 code! 


public class QuizCardBuilder { 


private 


ArrayList<QuizCard> cardList = new ArrayList<>(); 


private JTextArea question; 
private JTextArea answer; 


private 


JFrame frame; 


public static void main(String[] args) { 


new QuizCardBuilder().go(); 


public void go() { 


frame = new JFrame("Quiz Card Builder"); 
JPanel mainPanel = new JPanel (); 
Font bigFont = new Font ("sanserif", Font.BOLD, 24); 
question = createTextArea (bigFont) ; 

JScrollPane gqScroller = createScroller (question); 
answer = createTextArea(bigFont) ; 

JScrollPane aScroller = createScroller (answer); 
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mainPanel.add(new JLabel ("Question:")); 
mainPanel.add(qScroller) ; 
mainPanel.add(new JLabel ("Answer:")); 
mainPanel.add(aScroller) ; 

he 
JButton nextButton = new JButton ("Next Card"); Neat Card button os pressed 
nextButton.addActionListener(e -> nextCard()); next card metho 


mainPanel.add(nextButton) ; 


JMenuBar menuBar = new JMenuBar(); 


n 
JMenu fileMenu = new JMenu ("File"); the user clicks “New on 


age the clearAll method 
JMenuItem newMenuItem = new JMenultem("New") ; 
newMenultem.addActionListener(e -> clearAll()); is called. 
JMenuItem saveMenuItem = new JMenulItem("Save") ; When the kis l 
saveMenultem.addActionListener(e -> saveCard()); ENE menu, the saveC, Save” on 
SS is Called, eCard me hed 


fileMenu. add (newMenultem) ; 
fileMenu. add (saveMenultem) ; 


d! 
menuBar .add (fileMenu) ; =. enu, then put: ‘New’ make a File 
frame.setJMenuBar (menuBar) ; Hoy items into the F n Save 
ile me 

wda € menu to 4 fe da We 
frame.getContentPane() .add(BorderLayout.CENTER, mainPanel); t hen tell the £ hu bar 
frame.setSize(500, 600); 'S menu bar. nú nie to use 
frame.setVisible (true) ; an CtionEvent. Items Cay fire 
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private JScrollPane createScroller (JTextArea textArea) { 
JScrollPane scroller = new JScrollPane (textArea) ; 
scroller.setVerticalScrollBarPolicy (ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS) ; 
scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants.HORIZONTAL SCROLLBAR NEVER) ; 
return scroller; 


lot of sin; Pane or 3 
private JTextArea createTextArea(Font font) { thd. jinilar—loo ing lode 6 t area needs a 
JTextArea textArea = new JTextArea(6, 20); when ouple fh Iper iebhods T Put the ĉode 


textArea.setLineWrap (true) ; Wwe need a text 
textArea.setWrapStyleWord (true); 

textArea.setFont (font); 

return textArea; 


private void nextCard() { 
QuizCard card = new QuizCard(question.getText(), answer.getText()); 
cardList.add(card) ; 
clearCard(); 


private void saveCard() { 
QuizCard card = new QuizCard(question.getText(), answer.getText()); : 

i n this 
cardList.add(card) ; 


maS 
JFileChooser fileSave = new JFileChooser(); Bring . 
fileSave.showSaveDialog (frame); 


à he 
saveFile (fileSave.getSelectedFile()); —————— dial me a Kile, et» pA this easy: 
} me Che sev! It ally is Em! 
JFileChoo 
private void clearAll() { $ af 
cardList.clear(); When we want a new se + ike 
clearCard(); tards, we need to clear ou 7 
} tard list AND the text areas 
; yim 
private void clearCard() { L does h actual file able: 
question.setText (""); à tha Lener s eve À 
The metho uli S ser 1s s3 9 
answer.setText (""); by the Sa Gile ett the v 
; . (called ON ` the Ý 9 ext Page 
question.requestFocus (); ent is m the n 
} The en the File class o 
Well loo We thai 


na BufferedWi 


l , . sas FileWriter to riter on to a new 
private void saveFile(File file) { ZL (We'll talk daa a more efficient. 


— : Se n a few pages.) 
BufferedWriter writer = new BufferedWriter (new FileWriter (file) ); 
for (QuizCard card : cardList) { W- 
alk 
writer.write(card.getQuestion() + "/"); i ap the ArrayList of cards and 
writer.write(card.getAnswer() + "\n"); questi a. » One Card per line, with the 
On dnd ans 
} wer separated b wp 
. a / 
writer.close(); en add a newline character ct ai 
} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 
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The java.io.File AEte 


The java.io.File class is another example of an older class in the 
Java API. It’s been “replaced” by two classes in the newer 
java.nio.file package, but you'll undoubtedly encounter code 
that uses the File class. For new code, we recommend using 
the java .nio.file package instead of the java.io.File 
class. In a few pages, we’ll take a look at a few of the most important 
capabilities in the java.nio.file package. With that said... 


The java.io.File class represents a file on disk but doesn’t actually 
represent the contents of the file. What? Think of a File object as 
something more like a path name of a file (or even a directory) rather 
than The Actual File Itself. The File class does not, for example, have 
methods for reading and writing. One VERY useful thing about a File 
object is that it offers a much safer way to represent a file than just 
using a String filename. For example, most classes that take a String 
filename in their constructor (like FileWriter or FileInputStream) 

can take a File object instead. You can construct a File object, verify 
that you've got a valid path, etc., and then give that File object to the 
FileWriter or FileInputStream. 


Some things you can do with a File object: 


@ Make a File object representing an 
existing file 


File f = new File ("MyCode.txt") ; 


@ Make a new directory 
File dir = new File("Chapter7") ; 
dir.mkdir(); 


@ List the contents of a directory 


if (dir.isDirectory()) { 
String[] dirContents = dir.list(); 
for (String dirContent : dirContents) { 
System. out .printin (dirContent) ; 
} 
} 


@ Delete a file or directory (returns true if 
successful) 


boolean isDeleted = f.delete(); 
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Al 
Sheery Dorcis = 


7360 Foo Drive 


A File object represents the 
name and path of a file or 
directory on disk, for example: 


/Users/Kathy/Data/Game.txt 


But it does NOT represent, or 
give you access to, the data in 
the file! 


An address is NOT the 
same aS the pa 


| A File o ett is 
ae street a ene 


Fort Hueneme ,cA it represents the name 
p ————— and lotation 4 
A file bok ' 
isnt the file itse 
ts, the 
b ek represen 
A Ee andr iett 
GameFile.txt 


50,EIf,bow, sword,dust 
200,Troll,bare hands,big ax 
120,Magician,spells,invisibility 


A 
A File obj 


represen 
dirett access 


data inside the ue 
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The beauty of buffers 


If there were no buffers, it would be like 
shopping without a cart. You'd have to 
carry each thing out to your car, one soup 
can or toilet paper roll at a time. 


gr. 
ike the tay Di D until the bolder 


ar tewer trips whe make 


h You use 3 bu Fer. 


String is put into a buffer When the buffer is full, the 


Aspen 
with other Strings Strings are all written to 


Denver 


“Boulder” _____»| Boulder 
is written to 
String 


BufferedWriter FileWriter 


(a chain stream that (a connection stream 
works with characters) 


File 


that writes characters 
as opposed to bytes) 


BufferedWriter writer = new BufferedWriter (new FileWriter (aFile)); Notie th 4 
ice that we dop’? 
need to ke ont even 
epa 
the Filewit, reference to 


Using buffers is much more efficient than working without them. You can write to 


a file using FileWriter alone, by calling write(someString), but FileWriter writes B. i ning we Care about is the 
each and every thing you pass to the file each and every time. That’s overhead the ob; eet oT because that’s 
you don’t want or need, since every trip to the disk is a Big Deal compared to on, a es e ll methods 
manipulating data in memory. By chaining a BufferedWriter onto a FileWriter, the Buffere dWej re Close the 
BufferedWriter will hold all the stuff you write to it until it’s full. Only when the buffer ave of the rel of will take 

as full will the File Writer actually be told to write to the file on disk. the chain. 


If you do want to send data before the buffer is full, you do have control. 
Just Flush It. Calls to writer.flush() say, “send whatever’s in the buffer, now!” 


you are here > 


destination 


565 


reading files 


Reading from a text file 


Reading text from a file is simple, but this time we'll use a File object 
to represent the file, a FileReader to do the actual reading, and a 
BufferedReader to make the reading more efficient. What’s 2 + 22/4 


What’s 20+22/42 


The read happens by reading lines in a while loop, ending the loop when 
the result of a readLine() is null. That’s the most common style for 
reading data (pretty much anything that’s not a Serialized object): read 
stuff in a while loop (actually a while loop tes), terminating when there’s 
nothing left to read (which we know because the result of whatever read 
method we’re using is null). 


import Jjava.io.*; 


A file with two lines of text. 


K Do t forget the import- 


MyText.txt 
class ReadAFile { . 
public static void main(String[] args) { A FileReader is a Connection stream for 
tryd characters that connects to a text file. 
File myFile = new File ("MyText .txt") ; 
FileReader fileReader = new FileReader (myFile) ; 
BufferedReader reader = new BufferedReader (fileReader) ; A boa 
x gaer 
. ; to hold -n the FileRe ove 
Make a String a vead ~ G TeredReader fan go back 
eath lime as the “Y CC cient ve dino; à ont when the 
String line; 4 the {ile to “betavse ae wv. 
while ((line = reader.readLine()) != null) { pucker is em? ue every ching ™ 
System. out .printin (line); program has © 
} This says, “Read a |i 
reader .close() ; String variable haat it and assign it to the 
ecause there WAC reli, pi variable is not null 
i [} . 
} catch (IOException e) { ine that was just read.” "3 read), Print out the 
e.printStackTrace () ; Or another way of saying it, “ 
to n9 it, “Whil Spa: 
} read, read then and Print oe are still lines 
} 
Java 8 Streams and 1/0 
If you're using Java 8 and you feel comfortable using the Streams API, 
you can replace all the code inside the try block with the following: 
Files.lines (Path.of ("MyText .txt") ) 
.forEach (line -> System.out.printi1n (line) ); 
We'll see the Files and Path classes later in this chapter. 
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Quiz Card Player (code outline) 


public class QuizCardPlayer { 


public void go() { 
// build and display gui 


private void nextCard() { 
// if this is a question, show the answer, otherwise show 
// next question set a flag for whether we’re viewing a 
// question or answer 


private void open() { 
// bring up a file dialog box 
// let the user navigate to and choose a card set to open 


private void loadFile(File file) { 
// must build an ArrayList of cards, by reading them from 
// a text file called from the OpenMenuListener event handler, 
// reads the file one line at a time and tells the makeCard() 
// method to make a new card out of the line (one line in the 
// file holds both the question and answer, separated by a “/”) 


private void makeCard(String lineToParse) { 
// called by the loadFile method, takes a line from the text file 
// and parses into two pieces—question and answer—and creates a 
// new QuizCard and adds it to the ArrayList called CardList 
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Quiz Card Player code 


import javax.swing.*; 
import java.awt.*; 

import java.io.*; 

import java.util.ArrayList; 


public class QuizCardPlayer { 
private ArrayList<QuizCard> cardList; 
private int currentCardIndex; 
private QuizCard currentCard; 
private JTextArea display; 
private JFrame frame; Just 6u| Code on 
private JButton nextButton; ho hing special. 
private boolean isShowAnswer; 


this Page; 


public static void main(String[] args) { 
QuizCardPlayer reader = new QuizCardPlayer()j; 
reader.go(); 


public void go() { 
frame = new JFrame("Quiz Card Player"); 
JPanel mainPanel = new JPanel (); 
Font bigFont = new Font ("sanserif", Font.BOLD, 24); 


display = new JTextArea(10, 20); 
display.setFont (bigFont) ; 
display.setLineWrap (true) ; 
display.setEditable (false); 


JScrollPane scroller = new JScrollPane (display); 


scroller.setVerticalScrollBarPolicy (ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS) ; 


scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants.HORIZONTAL SCROLLBAR_N 


EV 


ER) ; 


mainPanel.add (scroller); 


nextButton = new JButton ("Show Question"); 
nextButton.addActionListener(e -> nextCard()); 
mainPanel.add(nextButton) ; 


JMenuBar menuBar = new JMenuBar(); 

JMenu fileMenu = new JMenu ("File"); 

JMenuItem loadMenuItem = new JMenuItem("Load card set"); 
loadMenuItem.addActionListener(e -> open()); 
fileMenu. add (loadMenuItem) ; 

menuBar. add (fileMenu) ; 

frame.setJMenuBar (menuBar) ; 


frame.getContentPane().add(BorderLayout.CENTER, mainPanel); 
frame.setSize(500, 400); 
frame.setVisible (true); 
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private void nextCard() { 
if (isShowAnswer) { 
// show the answer because they’ve seen the question 
display.setText (currentCard.getAnswer()); 


nextButton.setText ("Next Card"); Cheek the isCh, A 
isShowAnswer = false; see if they're Ah nswer boolean flag b 
} else { // show the next question or an answer pega Viewing a question 
if (currentCardIndex < cardList.size()) { thing dependi nd do the appropriate 
showNextCard () ; ind on the answer. 
} else { 


// there are no more cards! 
display.setText ("That was last card"); 
nextButton.setEnabled(false) ; 


private void open() { A let them 
JFileChooser fileOpen = new JFileChooser(); _ the file dialog, box an p 
fileOpen. showOpenDialog (frame) ; Bring i ko and ehoose the tile 
loadFile (fileOpen.getSelectedFile()); navigate 
hame! 
dReader & 
ke a Butfere wing the 
private void loadFile(File file) { ae REN FileReader ojvin nares 
cardList = new ArrayList<>(); FileReader the File oe dialog, 
currentCardIndex = 0; ehose from the open We 
try { 
BufferedReader reader = new BufferedReader (new FileReader (file) ); ee 
String line; at a time, passin the w 
while ((line = reader.readLine()) != null) { Read a line â (0) ethod tha parses ; 
makeCard (line); the makeCard ie veal QuizCard and 
and buns tt into $ is 
‘ rra 
reader.close(); adds ib to the Away 
} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 


} 


Now time to start, 
howNextCard(); 7 
a E a hese acd, 


String[] result = lineToParse.split("/"); flasheard, but we have to Parse out the 


private void makeCard(String lineToParse) { a Each line of text corresponds toa single 
QuizCard card = new QuizCard(result[0], result[1]); question and answer as separate pieces. We 


eae rage ennty ese Sirina split() method to break the 
System.out.printin("made a card"); line into two saree (one for the question 
i and one for the answer). We'll look at the 


split() method on the next page- 
private void showNextCard() { 
currentCard = cardList.get (currentCardIndex) ; 
currentCardIndex++; 
display.setText (currentCard.getQuestion()); 
nextButton.setText ("Show Answer"); 
isShowAnswer = true; 
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Parsing with String split() 


Imagine you have a flashcard like this: Saved Ine question Mie ike this: 


Question What is blue + yellow?/green 
What is red + blue?/purple 


What is blue + yellow? 


Answer 


How do you separate the question and answer? 


When you read the file, the question and answer are smooshed 
together in one line, separated by a forward slash "/" (because 
that's how we wrote the file in the QuizCardBuilder code). 


String split() lets you break a String into pieces. 


The split() method says, “give me a separator, and I'll break out all 
the pieces of this String for you and put them in a String array." 


0 Gs» 


token 1 separator token 2 


i app, this ìs 
In tre QuizCard olks like when 


hat a single | 
— ns vead KG from the file. 


String toTest = "What is blue + yellow?/green"; The split() ethod tik 
metho es 


th y» 7 
String[] result = toTest.split("/"); e break apart the String into Cr ue i ie 


Pieces, token | and token 2. (Note: splitQ is FAR 


tor. (String token: Fesult) "4 Ik es Powertul than what we're using it for here 
System. out .print1n (token) ; 1 wil a ey complex Parsing with filter 
oop through the ary oi ? 
: a ; 
} No ee sae In this example, ha = each token 
ens: What is blue + yellow?” e only two 


and “oreen.” 
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Dumb Questions 


Q: OK, I look in the API and there are about five 
million classes in the java.io package. How the heck do 
you know which ones to use? 


A: The I/O API uses the modular “chaining” concept so 
that you can hook together connection streams and chain 
streams (also called “filter” streams) in a wide range of 
combinations to get just about anything you could want. 


The chains don’t have to stop at two levels; you can hook 
multiple chain streams to one another to get just the right 
amount of processing you need. 


Most of the time, though, you'll use the same 

small handful of classes. If you're writing text files, 
BufferedReader and BufferedWriter (chained to FileReader 
and FileWriter) are probably all you need. If you're writing 
serialized objects, you can use ObjectOutputStream and 
ObjectInputStream (chained to FilelnputStream and 
FileOutputStream). 


In other words, 90% of what you might typically do with 
Java I/O can use what we've already covered. 


Q: You just said we've already learned 90% of what 
we'll probably use, but we haven't seen the fabled NIO.2 
stuff yet. What gives? 


A: NIO.2 is coming up on the very next page! But 

for reading and writing text files, BufferedReaders and 
BufferedWriters are still usually the way to go. So we'll be 
looking at how NIO.2 makes using them easier. 


Q: My brain is a little tired, and I’ve heard NIO.2 is 
pretty complicated. 


A: We're going to focus on a few key concepts in the 
java.nio.file package. 


Make it Stick 


Roses are first, violets 


Readers and 


m BULLET POINTS 


serialization and file I/O 


Java is 
Pass 


by value 
Wash | 
threads Cat | 
wait? — 
potityO 


are next. 
nly for text. 


Writers are 0 


To write a text file, start with a FileWriter 
connection stream. 


Chain the FileWriter to a BufferedWriter for 
efficiency. 

A File object represents a file at a particular 
path, but does not represent the actual 
contents of the file. 


With a File object you can create, traverse, 
and delete directories. 


Most streams that can use a String filename 
can use a File object as well, and a File object 
can be safer to use. 


To read a text file, start with a FileReader 
connection stream. 


Chain the FileReader to a BufferedReader for 
efficiency. 

To parse a text file, you need to be sure the 
file is written with some way to recognize the 
different elements. A common approach is to 
use some kind of character to separate the 
individual pieces. 

Use the String split() method to split a String 
up into individual tokens. A String with one 
separator will have two tokens, one on each 
side of the separator. The separator doesn’t 
count as a token. 
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NIO.2 and the EMRA} package 


Java NIO.2 is usually taken to mean two packages added in Java 7: 


java.nio.file A Path object represents 
the location (name and 
path) of a file or directory 
The java.nio.file.attribute package lets you manipulate the on disk, for example: 
metadata associated with a computer’s files and directories. For example, you 


java.nio.file.attribute 


/Users/Kathy/Data/Game.txt 


would use the classes in this package if you wanted to read or change a file’s 
permissions settings. We WON’T be discussing this package further. (phew) But it does NOT represent, 
or give you access to, the 


The java.nio.file package is all you need to do common text file data in the file! 


reading and writing, and it also provides you with the ability to manipulate 
a computer’s directories and directory structure. Most of the time you'll use 
three types in java.nio.file: 


= The Path interface: You'll always need a Path object to locate the 
directories or files you want to work with. 


= The Paths class: You’ll use the Paths.get() method to make the Path object An advanced but 
you'll need when you use methods in the Files class. useful capability 
a The Files class: This is the class whose (static) methods do all the l in the Files class 
work you'll want to do: making new Readers and Writers, and creating, 4 
modifying, and searching through directories and files on file systems. allows you to ‘walk 
» 

thru” (search) 

A mini-tutorial, creating a BufferedWriter with NIO.2 directory trees. 


@ Import Path, Paths, and Files: 
import java.nio.file.*; 


j i i mputer 
A Path object is used to locate a file on a Compu 
@ Make a Path object using the Paths “a ek ie file system). A path tan be used to lobe 


djass: Liles in the current directory or in other directories. 


Path myPath = Paths.get ("MyFile.txt") ; 


The “7” in “/myApp” is called the 


Or, if the file is in a subdirectory like: pee epending on which 
/my App/files/MyFile.txt : ene using, Your name—separator 
mig e different; or example, it 
Path myPath = Paths.get("/myApp", "files", "MyFile.txt") ; might be “V”. 
© Make a new BufferedWriter using a Path and Somewhere—under the Covers—some 
the Files class: method is saying: 
BufferedWriter writer = Files .newBufferedWriter (myPath) ; BufferedWriter writer = 


new BufferedWriter(..) 
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Path, Paths, and Files (messing with directories) 


In Appendix B, we'll be discussing how to split your Java app into packages. This includes creating the 
proper directory structure for all of your app’s files. In most cases you’ll make and move directories and 
files by hand, using the command line or utilities like the Finder or Windows Explorer. But you can also 
do it from within your Java code. 


Warning! Goofing around with directories in a Java program is a real “can of worms” topic. To do it 
correctly you need to learn about paths, absolute paths, relative paths, OS permissions, file attributes, 
and on and on. Below is a greatly simplified example of messing around with directories, just to give you 
a feel for what’s possible. 


Suppose you wanted to make an installer program to install your killer app. You start with the directory 
and files on the left, and want to end up with the directory structure and files on the right. 


Run the Install 


elass from here- 


Compil ed tode 
lands here. 


Install.class MyApp.class MyMedia.jpeg 


import java.nio.file.*; 
public class Install { 
public static void main(String[] args) { 
try 4 

Path myPath = Paths.get ("MyApp") ; 
Path myPath2 = Paths .get ("MyApp", "media"); 
Path myPath3 = Paths .get ("MyApp", "source"); Create all the 
Path mySource = Paths.get ("MyApp.class"); Path locations: 
Path myMedia = Paths.get ("MyMedia. jpeg"); 


Create the three 


MyApp.class MyMedia.jpeg 


Files.createDirectory (myPath) ; -~ petories: 
. A new diret 
Files.createDirectory (myPath2); LA| 
Files.createDirectory (myPath3) ; Move the two 
Files.move (mySource, myPath3.resolve(mySource.getFileName()))j; files into ee 
; ies. 
Files.move (myMedia, myPath2.resolve (myMedia.getFileName()))j; new director 


} catch (Exception e) { 
System.out.printin("Got an NIO Exception" + e.getMessage()); 
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Finally, a closer look at finally 


Several chapters ago we looked at how try-catch-finally worked. Kind of. All we 
said about finally was that it was a good place to put your “cleanup code.” That’s 
true, but let’s get more specific. Most of the time, when we talk about “cleanup 
code,” we mean closing resources we borrowed from the operating system. When 
we open a file or a socket, the OS is giving us some of its resources. When we’re 
done with them, we need to give them back. Below is a snippet of code from the 
QuizCardBuilder class. We highlighted a call to a constructor and three separate 
method calls... 


That’s FOUR places an exception can be thrown! 


private void saveFile(File file) { 
try { 
BufferedWriter writer = new BufferedWriter (new FileWriter (file) ) ; 
for (QuizCard card : cardList) { 
writer.write(card.getQuestion() + "/"); 


writer.write (card.getAnswer() + "\n"); All the places an exception 
} ould be thrown! 
writer.close(); 
} catch (IOException ee 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 


} 


If the call to make a new FileWriter fails, if ANY of the many write() invocations 
fail, or the close() itself fails, an exception will be thrown, the JVM will jump to 
the catch block, and the writer will never be closed. Yikes! 


Remember, finally ALWAYS runs!! 


Since we REALLY want to make sure we close the writer file, let’s put the close() 
invocation in a finally block. 


ger your pencil Coding the new finally block 


What changes will we have to make to the code 
above to move the close() to a finally block? 


> Yours to solve. There might be more than you first imagine. 
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Finally, a closer look at finally, cont. 


The amount of code required to put the close() in the finally block might surprise 


you; let’s take a look. 


private void saveFile(File file) { We had to declare the writer 
BufferedWriter writer = null; e——_~ reference outside of the try 
try { block so that it’s visible in 
i i ile)); the Finally block. 


writer = new BufferedWriter (new FileWriter (file) 


for (QuizCard card : cardList) { 
writer.write (card.getQuestion() + "/"); 
writer.write (card.getAnswer() + "\n"); 

} 

writer.close(); 


} catch (IOException e) { 
System.out.printlin("Couldn't write the cardList out: " + e.getMessage()); 


} finally { 
ery A 
writer.close(); 
} catch (Exception e) { 
" + e.getMessage()); 


System.out.printin("Couldn't close writer: 
} 
} 
ae Yup, we had to put the nae in 
yet another try—cateh block! 


Are you kidding me right now? 
I have to write all of this code 
every time I want to do a little 
I/O? Verbose much? 


There IS a better way! 


In the early days of Java, this is how you had to make sure you 
were really closing a file. You are very likely to encounter finally 
blocks that look like this when you’re looking at existing code. But 


for new code, there is a better way: 


Try-With-Resources 


We'll look at that next. 


you are here > 


575 


saving objects 


The try-with-resources (TWR), statement 


If you’re using Java 7 or later (and we sure hope you are!), you can use the 
try-with-resources version of try statements to make doing I/O easier. Let’s 
compare the try code we’ve been looking at with try-with-resources code that 


does the same thing: 


private void saveFile(File file) { 
BufferedWriter writer = null; Old style, 


try { jj try—eateh—f inally 


writer = new BufferedWriter(new FileWriter (fil 
tode 


for (QuizCard card : cardList) { 
writer.write(card.getQuestion() + "/"); 
writer.write(card.getAnswer() + "\n"); 


} 


} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: 
} finally { 
try { 
writer.close(); 
} catch (Exception e) { 
System.out.printlin("Couldn't close writer: " + e.getMessage()); 


} 


" + e.getMessage()); 


} 


private void saveFile (File file) { 
try (BufferedWriter writer = Modern, 


new BufferedWriter (new FileWriter (file))) { i ith t 
rY—with—resources 
on 


for (QuizCard card : cardList) { 
writer.write(card.getQuestion() + "/"); 
writer.write(card.getAnswer() + "\n"); 


} 


} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 


} 


thereareno 
Dumb Questions 


: Wait, what? You told us that a try statement needs a catch 
and/or a finally? 


A: Nice catch! It turns out that when you use try-with-resources, 
the compiler makes a finally block for you. You can't see it, but it’s 


there. 
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Autocloseable, the very small catch 


On the last page we saw a different kind of try statement, the try-with-resources 
statement (TWR). Let’s take a look at how to write and use TWR statements by 


first, deconstructing the following: ONLY classes 


try (BufferedWriter writer = 


that implement 


new BufferedWriter (new FileWriter(file))) { Autocloseable ean. 


be used in TWR 


Writing a try-with-resources statement 


statements! 


@ Add a set of parentheses between “try" and “{": 


try (...) { 
@ Inside the parentheses, declare an object Like all of the [/0 classes 
whose type implements Autocloseable: we've been using this Chapter, 
vee PRP BufferedWriter implements 
try (BufferedWriter writer = Autocloseable. 


new BufferedWriter (new FileWriter(file))) { 


© Use the object you declared inside the try block 
(just like you always did): 


writer .write(card.getQuestion() + "/"); 
writer.write(card.getAnswer() + "\n"); 


Autocloseable, it’s everywhere you do 1/0 


Autocloseable is an interface that was added to java.lang in Java 7. Almost all of 
the I/O you're ever going to do uses classes that implement Autocloseable. You 
mostly won’t have to think about it. 


There are a few more things worth knowing about TWR statements: 
a You can declare and use more than one I/O resource in a single TWR block: 


try (BufferedWriter writer = 
new BufferedWriter (new FileWriter (file) ); Separate the vešourtes 
BufferedReader reader = using, semicolons, °; - 
new BufferedReader (new FileReader (file))) { 


= If you declare more than one resource, they will be closed in the order 
OPPOSITE to which they were declared; i.e., first declared is last closed. 


= If you add catch or finally blocks, the system will handle multiple close() 
invocations gracefully. 
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* K 
x Code Kitchen 


% 


(EE) Cyber BeatBox When| You click 
«eriahizelt, the 
Bass Drum | @. Start ma + pattern 
ť A vr 
Closed Hi-Hat [) (| a saved. 
Gaariehe: @ O O O O O O O O O O O O O ea 
Tempo Up 


Acoustic Snare 
Crash Cymbal 


Tempo Down 


Hand Clap ( @ i pf » f ) T ) Bo e 8 serializelt 
High Tom (E E E E E E E E E E a e a E 8 restore 
Hi Bongo e iS 
0 | & v v 0 o0 g v 0 í iy » 
Seed - 4 a i sa sa © © restore” loads the saved 
Whistle | | i en back in, and resets 
Low Conga Se } Se oe he cheekbo s. 
Cowbell ) ( ( ) ] 


Vibraslap 


Low-mid Tom 


High Agogo 


Open Hi Conga | 


Let’s make the BeatBox save and 
restore our favorite pattern. 
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Saving a BeatBox pattern 


Remember, in the BeatBox, a drum pattern is nothing more than a bunch of 
checkboxes. When it’s time to play the sequence, the code walks through the 
checkboxes to figure out which drums sounds are playing at each of the 16 beats. So 
to save a pattern, all we need to do is save the state of the checkboxes. 


We can make a simple boolean array, holding the state of each of the 256 
checkboxes. An array object is serializable as long as the things in the array are 
serializable, so we'll have no trouble saving an array of booleans. 


To load a pattern back in, we read the single boolean array object (deserialize it) and 
restore the checkboxes. Most of the code you’ve already seen, in the Code Kitchen 
where we built the BeatBox GUL so in this chapter, we look at only the save and 
restore code. 


This GodeKitchen gets us ready for the next chapter, where instead of writing the 
pattern to a file, we send it over the network to the server. And instead of loading a 
pattern in from a file, we get patterns from the server, each time a participant sends 
one to the server. 


Senaližing a pattern This is a method in the BeatBox tode. We i 7 
tall this from a lambda expression when we as 
ActionListener ko the serializelt button, or 


À Ils this. 
private void writeFile() { ActionListener mner elass that calls 


boolean[] checkboxState = new boolean[256]; — Make a boolean arra 


s 
for (int i = 0; i < 256; i++) { W: 
JCheckBox check = checkboxList.get (i); Bk through the checkboxli 4 
if (check.isSelected()) { the yList of checkboxes), get 
checkboxState[i] = true; bo the iS eath one, and add it 
oolea 


n array. 


y to hold the 


€ each Checkbox. 


} 
} 


try (ObjectOutputStream os = 
new ObjectOutputStream(new FileOutputStream("Checkbox.ser"))) { Try 

os .writeObject (checkboxState) ; This art? 
} catch (IOException e) { ira he 
e.printStackTrace () ; seriali 


} 


with-vesowr CES 


Piece of cake. Just 
ze the one boolean array! 
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Restoring a BeatBox pattern 


This is pretty much the save in reverse...read the boolean array and use it to restore 
the state of the GUI checkboxes. It all happens when the user hits the “restore” 
button. 


Restoring a pattern 
This is another method in the 
BeatBox elass. 


private void readFile() { 
boolean[] checkboxState = null; 
try (ObjectInputStream is = ath resour Les 
new ObjectInputStream(new FileInputStream("Checkbox.ser"))) { hee 
checkboxState = (boolean[]) is.readObject () ; ¢ 
Read the Sin 


} catch (Exception e) { b gle ob; . 
e.printStackTrace () ; oolean array) pect n the fil ( 
} oolean arr y dn Cast it back to the 
return X ive ember, y S 
for (int i = 0; i < 256; i++) { 5 2 reterence of 4, s op eject0 
or (int i = 0; i PEE : 


JCheckBox check = checkboxList.get (i) ; N. 
check. setSelected (checkboxState[i]); ie P a n aa él ras the 

} in the ArrayList è 
JCheckBox objects era Git n 


sequencer.stop() ; l l 
buildTrackAndStart () ; Now stop whatever is currently playing, 
and rebuild the the using the new 


state of the checkboxes in the ArrayList. 


—> Yours to solve. 


G harpen your pencil 


IN This version has a huge limitation! When you hit the “serializelt” button, it 
serializes automatically, to a file named “Checkbox.ser” (which gets created if it 
doesn't exist). But each time you save, you overwrite the previously saved file. 


Improve the save and restore feature by incorporating a JFileChooser so that 
you can name and save as many different patterns as you like, and load/restore 
from any of your previously saved pattern files. 
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—+> Yours to solve. 


Object type 
Object 

String 

File 

Date 
OutputStream 
JFrame 
Integer 


System 


What's Legal? 


Circle the code fragments 
that would compile (assuming 
they're within a legal class). 


KEEP 


<~ 
RIGHT 


—— Yours to solve. 
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Can they be saved? 


Which of these do you think are, or should be, 
serializable? If not, why not? Not meaningful? 
Security risk? Only works for the current 
execution of the JVM? Make your best guess, 
without looking it up in the API. 


Serializable? If not, why not? 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


FileReader fileReader = new FileReader() ; 
BufferedReader reader = new BufferedReader (fileReader) ; 


FileOutputStream f = new FileOutputStream("Foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (f); 


BufferedReader reader = new BufferedReader (new FileReader (file) ) ; 
String line; 
while ((line = reader.readLine()) != null) { 

makeCard (line) ; 


} 


FileOutputStream f = new FileOutputStream ("Game.ser") ; 
ObjectInputStream is = new ObjectInputStream(f) ; 
GameCharacter oneAgain = (GameCharacter) is.readObject () ; 
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exercise: True or False 


This chapter explored the wonderful world 
of Java I/O. Your job is to decide whether 
each of the following |/O-related statements 
is true or false. 


2 TRve or Fase $ 


1. Serialization is appropriate when saving data for non-Java programs to use. 
2. Object state can be saved only by using serialization. 

3. ObjectOutputStream is a class used to save serializable objects. 

4. Chain streams can be used on their own or with connection streams. 

5. A single call to writeObject() can cause many objects to be saved. 

6. All classes are serializable by default. 

7. The java.nio.file.Path class can be used to locate files. 

8. If a superclass 1s not serializable, then the subclass can’t be serializable. 

9. Only classes that implement AutoCloseable can be used in try-with-resources statements. 
10. When an object is deserialized, its constructor does not run. 

11. Both serialization and saving to a text file can throw exceptions. 

12. BufferedWriters can be chained to FileWriters. 

13. File objects represent files, but not directories. 

14. You can’t force a buffer to send its data before it’s full. 

15. Both file readers and file writers can optionally be buffered. 

16. The methods on the Files class let you operate on files and directories. 


17. ‘Try-with-resources statements cannot include explicit finally blocks. 


—————> Answers on page 584. 
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Code Magnets 


This one’s tricky, so we promoted it from an Exercise to full Puzzle status. 
Reconstruct the code snippets to make a working Java program that pro- 
duces the output listed below. (You might not need all of the magnets, and 
you may reuse a magnet more than once.) 


(oN 
a 


nGame implements Serializable { 


class Dungeo 


putstream fos = new 


eam("dg.sexr") i 


FileOut shane setae 


e UtStr 
FileOutp return z; 


e.printStackTrace () 
— 


= new 


ObjectInputsStream ois 
int getX() 


object InputStream (fis) ; 


return x; 


System.out.printin(d.getX()t+td.getY()+d.getZ()); 


ey 


ublic int x = 3; 


FileInputStream fis = new 


FileInputStream("dg.ser"); 


ransient long y = 


rivate short z 


long getY() fí 


return yr 


Poo | 
fos.writeObject (d); 


d = (DungeonGame) ois.readObject (); 


oos.writedbject (d); 


] args) {í 


} catch (Exception e) 


ObjectOutputStream oos = new 


File Edit Window Help Torture 


% java DungeonTest 
12 


ObjectOutputStream(fos) ; 


8 


lic static void main (Stringl 


pub 


= new DungeonGame () 


DungeonGame d 


————> Answers on page 585. youarehere> 583 


exercise solutions 


Exercise Solutions 
Tre or Fatse 
(from page 582) 
1. Serialization is appropriate when saving data for non-Java programs to use. False 
2. Object state can be saved only by using serialization. False 
3. ObjectOutputStream is a class used to save serializable objects. True 
4. Chain streams can be used on their own or with connection streams. False 
5. A single call to writeObject() can cause many objects to be saved. True 
6. All classes are serializable by default. False 
7. The java.nio.file.Path class can be used to locate files. False 
8. If a superclass 1s not serializable, then the subclass can’t be serializable. False 


9. Only classes that implement AutoCloseable can be used in try-with-resources statements. True 


10. When an object is deserialized, its constructor does not run. True 
11. Both serialization and saving to a text file can throw exceptions. True 
12. BufferedWriters can be chained to FileWriters. True 
13. File objects represent files, but not directories. False 
14. You can’t force a buffer to send its data before it’s full. False 
15. Both file readers and file writers can optionally be buffered. True 
16. The methods on the Files class let you operate on files and directories. True 
17. ‘Try-with-resources statements cannot include explicit finally blocks. False 
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serialization and file I/O 


Good thing we're 
finally at the answers. 
I was gettin’ kind of 

tired of this chapter. 


Code Magnets 


(from page 583) 


import java.io.*; 


class DungeonGame implements Serializable { 
public int x = 3; 
transient long y = 4; 
private short z = 5; 


int getX() { 
return xX; 

} 

long getY() { 
return y; 

} 

short getZ() { 
return zZz}; 


class DungeonTest { 
public static void main(String[] args) { 

DungeonGame d = new DungeonGame () ; 

System.out.printlin(d.getX() + d.getY() + d.getZ()); 

try { 
FileOutputStream fos = new FileOutputStream("dg.ser") ; 
ObjectOutputStream oos = new ObjectOutputStream (fos); 
oos.writeObject (d); 
oos.close(); 


FileInputStream fis = new FileInputStream("dg.ser"); 
ObjectInputStream ois = new ObjectInputStreanm (fis); 
d = (DungeonGame) ois.readObject (); 

ois.close(); 

} catch (Exception e) { 

% java DungeonTest e.printStackTrace(); 

2 } 

System.out.printlin(d.getX() + d.getY() + d.getZ()); 
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Make a Connection 


Connect with the outside world. Your Java program can talk to a program on 
another machine. It’s easy. All the low-level networking details are taken care of by the built- 
in Java libraries. One of Java's big benefits is that sending and receiving data over a network 
can be just I/O with a slightly different connection at the end of the I/O chain. In this chapter 
we'll connect to the outside world with channels. We'll make client channels. We'll make server 
channels. We'll make clients and servers, and we'll make them talk to each other. And we'll also 
have to learn how to do more than one thing at once. Before the chapter’s done, you'll have 

a fully functional, multithreaded chat client. Did we just say multithreaded? Yes, now you will 


learn the secret of how to talk to Bob while simultaneously listening to Suzy. 
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beatbox chat 


Real-time BeatBox chat 


a= —_— 
| Bass Drum a- =v oars Cyber BeatBox O00 
Closed Hi-Hat = a a z @ — OO 
Open Hi-H at E : @ @ a ] = = 
A] art 


| Acoustic Snare ~ z ” e @ @ E 


| Hand Clap _ Tempo up 
High Tom : _ Tempo Down 
| Hi i X - See 
Bongo : aie eee oe sendit 


Maracas fv] 
v ae 
| Whistle 4 a iV) a a Gag ~ "this one.. its better for 
Low Conga re 8 > @ — Sequence g 


Cowbel} | g ~ 
5290008 


a 


Low-mid Tom Skyler4: Beta n 
High Agogo Sequence 12 and funky, good for putton to = ND 
Open Hi evster2: [i message 
n Hi Conga @ @ fv] Oakenfol KeS kYler2, but more owr È erent b 
Skyler5: you WISH! Too perky Takter 


You’re working on a computer game. You and your team are ween 
eceived 


doing the sound design for each part of the game. Using a Clicking on a Y The _ 

“chat” version of the BeatBox, your team can collaborate— loads the pattern 

you can send a beat pattern along with your chat message, with it. 

and everybody in the BeatBox Chat gets ie 
e e Chat Client 


it. So you don’t just get to read the other = aicrously: simpl 
participants’ messages; you get to load = — 

and play a beat pattern simply by clicking 
the message in the incoming messages 


echicken street? 


g how to get to Sesam 


‘ ‘i ay 
el sateen one more time, ri take 
na abused, 


area. 
In this chapter we’re going to learn what it 
takes to make a chat client like this. We’re 
even going to learn a little about making a 
chat server. We’ll save the full BeatBox Chat 
for the Code Kitchen, but in this chapter 
you will write a Ludicrously Simple Chat 
Client and Very Simple Chat Server that 
send and receive text messages. 


a have Complete 
authentic, int, Il 

stimulating eee 
conversations. Every message 


is sent to all Participants. 


Send your message to the server. 
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Chat program overview 


Each Client has to know 
about the Server. 


The Server has to know 
about ALL the Clients. 


How it works: 


(1) Client connects to the server 


The server makes a 
connection and adds the client 
to the list of participants 


(3) Another client connects 


Client A sends a message to 
the chat service 


@ The server distributes the 
message to ALL participants 
(including the original sender) 


networking and threads 


‘ello, I’m A chat 


Client A 


I'm just going 


to B myself Server 


Can you C 
me? 


Client B 


Client C 
| — Server, l’d like to connect 
to the chat service. 


Client A Server 


4(— 0K, you're in. 


Client A 


Server, I'd like to connect 
| — to the chat service. 


4— K, you're in. — 


Client B TT 
|} __ “Who took the lava lamp 
from my dorm room?” 
Client A n 
«—— Who took the lava lamp 
aye mY dorm room?” 
Client A Teta =— 
Client B 


you are here > 
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socket connections 


Connecting, sending, and receiving 


The three things we have to learn to get the client working are: 

1. How to establish the initial connection between the client and server 
2. How to receive messages from the server 

3. How to send messages fo the server 


There’s a lot of low-level stuff that has to happen for these things to work. But we’re lucky, 
because the Java APIs make it a piece of cake for programmers. You'll see a lot more GUI 
code than networking and I/O code in this chapter. 


And that’s not all. 


Lurking within the simple chat client is a problem we haven’t faced so far in this book: 
doing two things at the same time. Establishing a connection is a one-time operation 
(that either works or fails). But after that, a chat participant wants to send outgoing messages 
and simultaneously receive incoming messages from the other participants (via the server). 
Hmm...that one’s going to take a little thought, but we’ll get there in just a few pages. 


© Connect 


Client connects to the server 


| Make a ¢onnettion to 
= 196.|b4.1.103 at port 5000 
Client A Server 


© Receive 


Client reads a message from the server 


Hl- String s = reader-readLine() 


Client A Server 


@ Send 


Client writes a message to the server 


w writer.printhn(aMessage) 


Client A Server 
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1. Connect 


connection between two machines. We can open a java.nio.channels. e 3 
SocketChannel to give us this connection object. things about the server: 
What’s a connection? A relationship between two machines, where two where it 19 and which 
pieces of software know about each other. Most importantly, those p e 

two pieces of software know how to communicate with each other. In other P ort it 5 running on. 
words, how to send bits to each other. In A er wor ds 

We don’t care about the low-level details, thankfully, because they’re , 

handled at a much lower place ne STeavOH IMS stack.” If eo don’t IP address and TCP 
know what the “networking stack” is, don’t worry about it. It’s just a way 

of looking at the layers that information (bits) must travel through to get port number. 


from a Java program running in a JVM on some OS, to physical hardware 
(Ethernet cables, for example), and back again on some other machine. 


The part that you have to worry about is high-level. You just have to 
create an object for the server’s address and then open a channel to that 
server. Ready? 


he 
he full address of t 
A e e tonnett to |P address for th 


InetSocketAddress serverAddress = new InetSocketAddress ("196.164.1.103", 5000); 
SocketChannel socketChannel = SocketChannel .open(serverAddress) ; 


Mh 


k +Channel ) 
ie talk D eee machine: Lu dont use i Constructor to 
n 2 . 
iis Tet ye call the statie openl) 


create a 
and Connect it to the adie a 


create a new 


The chat server is at 
196.164.1.103, port 5000. 
When I need to talk to it, 
that's where I'll send 


Port 5000 


This client is at 


Port 4247 


To make a connection, 
To talk to another machine, we need an object that represents a network you need to know two 


e server TCP Ps ort number, 
ae 


196.164.1.100, port 4242. 
When I need to talk to it, 
that's where I'll send the 
message. 


the message. 


196.164.1.100:4242 196.164.1.103: 5000 


A connection means the two machines have 
information about each other, including network 
location (IP address) and TCP port. 
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well-known ports 


592 


A TCP port is just a number... 


a 16-bit number that identifies a 
specific program on the server 


Your internet web (HTTP) server runs on port 80. That’s a 
standard. If you’ve got a Telnet server, its running on port 23. 
FTP? 20. POP3 mail server? 110. SMTP? 25. The Time server 
sits at 37. Think of port numbers as unique identifiers. They 
represent a logical connection to a particular piece of software 
running on the server. That’s it. You can’t spin your hardware 
box around and find a TCP port. For one thing, you have 65,536 
of them on a server (0-65535). So they obviously don’t represent 
a place to plug in physical devices. They’re just a number 
representing an application. 


Without port numbers, the server would have no way of knowing 
which application a client wanted to connect to. And since each 
application might have its own unique protocol, think of the 
trouble you’d have without these identifiers. What if your web 
browser, for example, landed at the POP3 mail server instead of 
the HTTP server? The mail server won’t know how to parse an 
HTTP request! And even if it did, the POP3 server doesn’t know 
anything about servicing the HTTP request. 


When you write a server program, you'll include code that tells 
the program which port number you want it to run on (you'll 

see how to do this in Java a little later in this chapter). In the 

Chat program we're writing in this chapter, we picked 5000. Just 
because we wanted to. And because it met the criteria that it be a 
number between 1024 and 65535. Why 1024? Because 0 through 
1023 are reserved for the well-known services like the ones we just 
talked about. 


And if you’re writing services (server programs) to run on a 
company network, you should check with the sysadmins to find 
out which ports are already taken. Your sysadmins might tell 
you, for example, that you can’t use any port number below, say, 
3000. In any case, if you value your limbs, you won’t assign port 
numbers with abandon. Unless it’s your home network. In which 
case you Just have to check with your kids. 
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FTP 


Well-known TCP port numbers 
for common server applications: 


Telnet cmt? 


ime 


HTTP 


HTTPS  PoP3 


A server tan have up to 65,536 
ditterent server apps running, 
one per port. 


The TCP port 
numbers from 0 to 1023 
are reserved for well- 


known services. Don’t 


use them for your own 
server programs!* 


The chat server we're 
writing uses Port 
5000. We just picked a 
number between 1024 
and 65535. 


“Well, you might be able to use one of 
these, but the sysadmin where you 
work will write you a strongly worded 
message and CC your boss. 


thereyareno — ; 
Dumb Questions 


Q: How do you know the port 
number of the server program you 
want to talk to? 


Å: That depends on whether the 
program is one of the well-known 
services. If you're trying to connect 
to a well-known service, like the ones 
on the opposite page (HTTP, SMTP, 
FTP, etc.), you can look these up on 
the internet (Google “Well-Known 
TCP Port”). Or ask your friendly 
neighborhood sysadmin. 


But if the program isn’t one of the 
well-known services, you need to 
find out from whoever is deploying 
the service. Ask them. Typically, if 
someone writes a network service 
and wants others to write clients for 
it, they'll publish the IP address, port 
number, and protocol for the service. 
For example, if you want to write a 
client for a GO game server, you can 
visit one of the GO server sites and 
find information about how to write a 
client for that particular server. 


Q: Can there ever be more than 
one program running on a single 
port? In other words, can two 
applications on the same server have 
the same port number? 


A: No! If you try to bind a program 
to a port that is already in use, 

you'll get a BindException. To binda 
program to a port just means starting 
up a server application and telling it to 
run on a particular port. Again, you'll 
learn more about this when we get to 
the server part of this chapter. 
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Port number is 
IP address is the mall store in the mal 


a specifie 


IP address is like specifyinga ~ 
particular shopping mall, say, 
“Flatirons Marketplace" 


Port number is like naming 
a specific store, say, 
“Bob's CD Shop" 


—_) 
Brain Barbell 


OK, you got a connection. The client and the server 
know the IP address and TCP port number for each 
other. Now what? How do you communicate over that 
connection? In other words, how do you move bits 

from one to the other? Imagine the kinds of messages 
your chat client needs to send and receive. 


Wow do these two 
actual talk to 


eath (o) her? 


Client 
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receiving from the server 


2. Receive Bisse Goes the 


client and server 
To communicate over a remote connection, you can use regular old I/O 
streams, just like we used in the previous chapter. One of the coolest / 
features in Java is that most of your I/O work won’t care what your 
high-level chain stream is actually connected to. In other words, you can 
use a BufferedReader just like you did when you were reading from a 
file; the difference is that the underlying connection stream is connected 
to a Channel rather than a File! 


i : 127.0.0.1 is the |P address for l 
Reading from the network with BufferedReader “localhost,” in other words, the one this 
tode is running on. You Can use this when 
you're testing your tlient and server on 
1) Make a connection to the server a single, stand-alone machine. You tould 
also use “localhost” here instead. 
SocketAddress serverAddr = new InetSocketAddress ("127.0.0.1", 5000); 


, which 
SocketChannel socketChannel = SocketChannel.open(serverAddr) ; [he ie ae a 
ow 
You need to open à SotketChannel 7 D you that pa 
hat tonnetts to this addvess is the port number tor 


: y chat server: 
Create or get a Reader from the connection = 


Reader reader = Channels .newReader (socketChannel, StandardCharsets.UTF_8) ; 


: a ise 4 d to on Charset to 
À isa or ; ; 
deel iye Ton a the static helper methods on W redia sae a 
j m the Channe i 2 . 

Shale paratter we your SoeketChannel. reate a Reader from = le oe 

ie the BufferedReader e 

after as our top of the chain B 
a der (whi 
m Chain the BufferedReader to the Reader 

is from our CotketChannel : 


3) Make a BufferedReader and read! 
— 


BufferedReader bufferedReader = new BufferedReader (reader); 
String message = bufferedReader.readLine (); 


soute 
destin . 
d 
\ tion buffered characters converted to characters bytes from server 
w buffered Sareaie| characters ey 011010011 |}¢#———— 
pm characters chained to chained to 

SocketChannel's data 

Client piirencdReader Peover (we don't need to know 
the actual class) Server 
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3, Send 


In the previous chapter, we used BufferedWriter. We have a choice here, but when you’re 
writing one String at a time, PrintWriter is a standard choice. And you'll recognize the 
two key methods in PrintWriter, print() and println()! Just like good ol’ System.out. 


Writing to the network with PrintWriter hes 
| sie Nett be write to the 


it 
ill have to tonnett to 
© Make a connection to the server J server, We st 


SocketAddress serverAddr = new InetSocketAddress ("127.0.0.1", 5000); 


SocketChannel socketChannel = SocketChannel.open(serverAddr) ; 


to say whith Charset to 


You need she Strings. You should 
2) Create or get a Writer from the connection a ae one for reading as 


Lor writing! 


Writer writer = Channels.newWriter(socketChannel, StandardCharsets.UTF_8) ; 


: between The Channels elass e ; AY 
wit a oe ie to be to treate a Weiter. Ta utility methods 
r 
ailen to the Channel: 


3) Make a PrintWriter and write (print) something 
— 


By chaining a PrintWriter to the Channel’s 


Writer, we ĉan wri 

write Strings to th 

. 7 e 

which will be sent over the A Channel, 
PrintWriter printWriter = new PrintWriter (writer) ; 


writer.printin("message to send"); ¢_ Println() add 
writer.print ("another message") ; s a new line at the end of 


PrintQ) doesn’t add the new line 


nnection. 


what it sends. 


destination 
source 
characters characters bytes to server 
[resin 
chained to chained to 
PrintWriter Writer SocketChannel's data 
Client (we don't need to know 


the actual class) 
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channels vs sockets 


There’s more than one way to 
make a connection tee eal 


: ; but I know that I could 
If you look at real life code that talks to a remote machine, use a Socket instead. 


you'll probably see a number of different ways to make 
connections and to read from and write to a remote computer. 


Which approach you use depends on a number of things, 
including (but not limited to) the version of Java you’re using 
and the needs of the application (for example, how many 
clients connect at once, the size of messages sent, frequency 
or message, etc). One of the simplest approaches is to use a 
java.net.Socket instead of a Channel. 


Using a Socket 


You can get an InputStream or OutputStream from a Socket, and read and 
write from it in a very similar way to what we’ve already seen. 


d 
. tSotketAddress an 
Instead ne aa you tan reste a 


Ta with the host and port number- 


To read from the 
Socket chatSocket = new Socket ("127.0.0.1", 5000); need to get a 


rom the Sotket. 


Socket, we 
n InputStream 


InputStreamReader in = new InputStreamReader (chatSocket .getInputStream() ) ; 
— 


) 
BufferedReader reader = new BufferedReader (in); Reader code is exactly the same as we ve 
String message = reader.readLine(); already seen. 


PrintWriter writer = new PrintWriter (chatSocket .getOutputStream() ) ; 


, we need to get 
writer.println ("message to send"); R To write to the ag so the Cotket, 
writer.print ("another message"); an OutputStream to the PrintWriter- 


ich we Can (À 
dy seen. whi 


) 
the same as we Ve alrea 


Writer code is exactly 


The java.net.Socket class is available in al] 
versions of Java. 


It supports simple network I/O via the I/O 
streams we've already used for file I/O. 
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If 
Socket has been in 
Java since forever, if it'sa 
bit less code to write, and if 
it does the same thing as 

Channels, why do we need 
Channels? 


As we’ve become an increasingly connected world, 
Java has evolved to offer more ways to work with 
remote machines. 


Remember that Channels are in the java.nio.channels package? The 
java.nio package (NIO) was introduced in Java 1.4, and there were 
more changes and additions made (sometimes called NIO.2) in Java 7. 


There are ways to use Channels and NIO to get better performance 
when you're working with lots of network connections, or lots of data 
coming over those connections. 


In this chapter, we’re using Channels to provide the same 
very basic connection functionality we could get from 
Sockets. However, if our application needed to work well with a 
very busy network connection (or lots of them!), we could configure 
our Channels differently and use them to their full potential, and our 
program would cope better with a high network I/O load. 


We've chosen to teach you the simplest way to get started with 
network I/O using Channels so that if you need to “level up” to 
working with more advanced features, it shouldn’t be such a big step. 


If you do want to learn more about NIO, read Java NIO by Ron 
Hitchens and Java I/O, NIO and NIO.2 by Jeff Friesen. 


= Relax Channels support advanced 


networking features that you 


don’t need for these exercises. 


4 
i Channels can support nonblocking I/O, reading 
and writing via ByteBuffers, and asynchronous 
I/O. We’re not going to show you any of this! 
But at least now you have some keywords to put into your 


search engine when you want to know more. 
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writing a client 


The DailyAdviceClient 


Before we start building the Chat app, let’s 
start with something a little smaller. The 
Advice Guy is a server program that offers 


Tell your boss 


Don't forget self-care; the report will 


you can't be effective have to wait. There's 


if you're running on 


h powder at Aspen! 
umes! 


up practical, inspirational tips to get you 
through those long days of coding. 


We’re building a client for The Advice Guy 


program, which pulls a message from the That shade of 
green isn't really 


workin' for you... 


server each time it connects. 


What are you waiting for? Who knows what 
opportunities you’ve missed without this app. 


The Advice Guy 


@ Connect 


Client connects to the server 


Make a Connection to 
H 190.145.1.103 at port 5000 


Client Server 


© Read 


Client gets a Reader for the Channel, and reads a message 
from the server 


| Channels.newReader() 
advice = readev-readLine() 


Client Server 
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DailyAdviceClient code 


This program makes a SocketChannel, makes a BufferedReader (with 
the help of the channel’s Reader), and reads a single line from the server 
application (whatever is running at port 5000). 


import java.io.*; 
import java.net .InetSocketAddress; 
import java.nio.channels.Channels; 


import java.nio.channels.SocketChannel; 


as being, port 
Define the server ae ana tode is 


ho 
OO, on the same 
public class DailyAdviceClient { 90 (the lotalhost’ ): 


running on 
public void go() { MDN 


InetSocketAddress serverAddress = new InetSocketAddress ("127.0.0.1", 5000); 


import java.nio.charset .StandardCharsets; 


try (SocketChannel socketChannel = SocketChannel.open(serverAddress)) { 


“ty—resourles Create as 
his uses tey-wit otketCh a , 
io avtomaticall de Create a Reader that reads for the server's adden PY opening one 


etChannel when from the SotketChannel. 
Sotk 


s complete- 
i i Reader channelReader = Channels.newReader (socketChannel, StandardCharsets.UTF_8) ; 


BufferedReader reader = new BufferedReader (channelReader) ; 


~ ~ Chana BufferedReader 
to the Reader from the 


String advice = reader.readLine() ; Peeks CotketChannel: 
System.out .printin("Today you should: " + advice); 


<i EXAC 
This closes the channelReader and ës ie ou ra is TLY 
reader.close(); ihis BufferedReader. Bu FeredRea fo) 


} catch (IOException e) { call a Bie by the time 
e.printStackTrace (); reader doesn’. k 


public static void main(String[] args) { 


new DailyAdviceClient () .go(); 
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exercise: sharpen your pencil 


harpen your pencil 


— j . 
DA Test your memory of the classes for reading and writing from a Yours to solve 


SocketChannel. Try not to look at the opposite page! 


Sour, 
To read text from a SocketChannel: te 


Write/draw in the chain of classes the client 
uses to read from the server. Server 


desti, aL: 
To send text to a SocketChannel: estination 


Write/draw in the chain of classes the client 


Client uses to send something to the server. Server 


re harpen your pencil 
DN Fill in the blanks: ——> Yours to solve. 


What two pieces of information does the client need in order to make a connection with a 
server? 


Which TCP port numbers are reserved for “well-known services” like HTTP and FTP? 


TRUE or FALSE: The range of valid TCP port numbers can be represented 
by a short primitive. 
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Writing a simple server application 


So what’s it take to write a server application? Just a couple of 
Channels. Yes, a couple as in two. A ServerSocketChannel, 
which waits for client requests (when a client connects) and 

a SocketChannel to use for communication with the client. 

If there’s more than one client, we’ll need more than one 
channel, but we’ll get to that later. 


How it works: 


@ Server application makes a ServerSocketChannel and binds it to a specific port 


ServerSocketChannel serverChannel = ServerSocketChannel.open () ; % 
serverChannel.bind (new InetSocketAddress (5000)); Server por 


i 


This starts the server application listening for client 
requests coming in for port 5000. 


© Client makes a SocketChannel connected to the server application 
SocketChannel svr = SocketChannel.open(new InetSocketAddress ("190.165.1.103", 5000)); 


Server port 


, Chert port 
Client knows the IP address and port number 


(published or given to them by whomever configures | 
the server app to be on that port). 


(3) Server makes a new SocketChannel to communicate with this client 


SocketChannel clientChannel = serverChannel.accept () ; 


The accept() method blocks (just sits there) while it's 

waiting for a client connection. When a client finally 

connects, the method returns a SocketChannel that | 
knows how to communicate with this client. we 


Chert port 


The ServerSocketChannel can go back to waiting 


for other clients. The server has just one 
ServerSocketChannel, and a SocketChannel per client. 
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writing a server 


DailyAdviceServer code 


This program makes a ServerSocketChannel and waits for client requests. When it gets a client request (i.e., client 
created a new SocketChannel to this server), the server makes a new SocketChannel to that client. The server 


makes a PrintWriter (using a Writer created from the SocketChannel) and sends a message to the client. 


import java.io.*; 
import java.net .InetSocketAddress; : cts. 
Remember the wok? 


import java.nio.channels.*; 
import java.util.Random; 
public class DailyAdviceServer { 

: j j Š ‘ = i vay. 
final private String[] adviceList $ aily 2 dvice Comes From this array 


"Take smaller bites", 
"Go for the tight jeans. No they do NOT make you look fat.", 


"One word: inappropriate", 
"Just for today, be honest. Tell your boss what you *really* think", 
"You might want to rethink that haircut."}; kes this server Ye 
= new Random() ; Ñ eket Channel ma ` X venes on 
Server>ot isten” For then 


private final Random random 


bli id applica i 
public void go() { oo a ae pound to 
ServerSocketChannel. open () ) a Cake Channel to 


try (ServerSocketChannel serverChannel = 
serverChannel.bind (new InetSocketAddress (5000)); Vou have to bind the Serv E 
y £ you want to run the application on- 


R___— the for 
ust sits there) until a 


to a permanent loop, ; 
ms enk ests. The accept method blocks ( 
peig diere oe Q request Comes in, and then te method returns a 


The server goes in 


pai Pe 
SotketChannel for Communicating, with the client. 


SocketChannel clientChannel = 
new PrintWriter (Channels .newOutputStream(clientChannel) ) ; 


= i : Create an output stream for the client’s 
ee channel, and wrap it in a PrintWriter. You tan 


String advice 
writer.printl1n (advice); ` 
5 : Eoo use newOutputStream or newWriter here. 


while (serverChannel.isOpen()) { 
serverChannel .accept () ; 


PrintWriter writer 


>." 
T% 
a 3 
oS writer.close(); 
-£ i i 
3S v ~>System.out .print1n (advice) ; Send the eli ; 
E $ > the tlient a String advice message. 
= 
pa 3} catch (IOException ex) { Close the writ 
ina Y  ex.printStackTrace () ; ey also Close a. we 
‘aah 
otketChanne] client —— > 


~ 


Brain Barbell 


private String getAdvice() { 
random.nextInt (adviceList .length) ; 
How does the server know how to 


int nextAdvice = 


~ 


return adviceList [nextAdvice]; 

i communicate with the client? 
public static yoid main(String] args) i Think about how/when/where the server 

gets knowledge about the client. 


new DailyAdviceServer ().go(); 


} 
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Wi 


The 
advice server code 
on the opposite page has a VERY 
serious limitation—it looks like it 
can handle only one client at a time! 
Is there a way to make a server 
that can handle multiple clients 
concurrently? This would never work 
for a chat server, for instance. 


f 


a> 


Yes, that’s right, the server can’t accept a 
request from a client until it has finished 
with the current client. At which point, it 
starts the next iteration of the infinite loop, 
sitting, waiting, at the accept() call until a new 
request comes in, at which point it makes a 
SocketChannel to send data to the new client 
and starts the process over again. 


To get this to work with multiple clients at the 
same time, we need to use separate threads. 


We'd give each new client's SocketChannel 
to a new thread, and each thread can work 
independently. 


We're just about to learn how to do that! 


___—— BULLET POINTS 


networking and threads 


Client and server applications communicate using Channels. 


A Channel represents a connection between two applica- 
tions that may (or may not) be running on two different 
physical machines. 


A client must know the IP address (or host name) and TCP 
port number of the server application. 


A TCP port is a 16-bit unsigned number assigned to a 
specific server application. TCP port numbers allow different 
server applications to run on the same machine; clients con- 
nect to a specific application using its port number. 


The port numbers from 0 through 1023 are reserved for 
“well-known services” including HTTP, FTP, SMTP, etc. 


A client connects to a server by opening a SocketChannel: 
SocketChannel . open ( 
new InetSocketAddress ("127.0.0.1", 4200) ) 


Once connected, a client can create readers (to read data 

from the server) and writers (to send data to the server) for 

the channel: 

Reader reader = Channels .newReader (sockCh, 
StandardCharsets.UTF_8) ; 

Writer writer = Channels.newWriter (sockCh, 
StandardCharsets.UTF_8) ; 


To read text data from the server, create a BufferedReader, 
chained to the Reader. The Reader is a “bridge” that takes 
in bytes and converts them to text (character) data. It’s used 
primarily to act as the middle chain between the high-level 
BufferedReader and the low-level connection. 


To write text data to the server, create a PrintWriter chained 
to the Writer. Call the print() or printIn() methods to send 
Strings to the server. 


Servers use a ServerSocketChannel that waits for client 
requests on a particular port number. 


When a ServerSocketChannel gets a request, it “accepts” 
the request by making a SocketChannel for the client. 
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a simple chat client 


Writing a Chat Client 


We'll write the Chat Client application in two stages. First we’ll make 
a send-only version that sends messages to the server but doesn’t get 


to read any of the messages from other participants (an exciting and 
mysterious twist to the whole chat room concept). 


Then we’ll go for the full chat monty and make one that both sends 
and receives chat messages. 
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Version One: send-only 


Emen Ludicrouslyi Simpie chat client | Type a message w 

a to send it to the a hs 
a get any messages FRO 
server m 
no strolling 


Code outline 


Here’s an outline of the main functionality the chat client needs to 
provide. The full code is on the next page. 


public class SimpleChatClientA { 
private JTextField outgoing; 
private PrintWriter writer; 


public void go() { 
// call the setUpNetworking() method 
// make gui and register a listener with the send button 


private void setUpNetworking() { 
// open a SocketChannel to the server 
// make a PrintWriter and assign to writer instance variable 


private void sendMessage() { 
// get the text from the text field and 
// send it to the server using the writer (a PrintWriter) 
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import 
import 
import 
import 
import 
import 
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j i -— feayaie), network 
javax.swing.*; writing (java.io ) N 
java.awt.*; r or ( java niochannel and the 
java.io. *; Mat stukl (awt and saing 


java.net .InetSocketAddress; : ; locked at 

java.nio.channels.*; This is a statie import; we ið. . 

static java.nio.charset .StandardCharsets.UTF_8; stati¢ imports m Chapter i 
Ore = TCS 


public class SimpleChatClientaA { 
private JTextField outgoing; 
private PrintWriter writer; 


publ 


i i | the method that will 
preety ya ae to the server- 


setUpNetworking () ; 


outgoing = new JTextField(20) ; 


JButton sendButton = new JButton ("Send") ; B ‘ld the gul, na be 
u e 


sendButton.addActionListener(e -> sendMessage() ) ; 


JP 


here, and nothing vela 


orking or i 
anel mainPanel = new JPanel (); netw 9 


mainPanel .add (outgoing) ; 

mainPanel.add(sendButton) ; 

JFrame frame = new JFrame ("Ludicrously Simple Chat Client"); 
frame .getContentPane() .add(BorderLayout.CENTER, mainPanel) ; 
frame.setSize(400, 100); 

frame.setVisible (true) ; 

frame .setDefaultCloseOperation (WindowConstants .EXIT_ON_CLOSE) ; 


private void setUpNetworking() { 
try { 


2) 

Were usin localhost. so You 

ĉan test fhe tlient and 

Server on one machine. 

InetSocketAddress serverAddress = new InetSocketAddress ("127.0.0.1", 5000); 
SoeketChannel 

SocketChannel socketChannel = SocketChannel.open(serverAddress) x i t pits ets to the 

writer = new PrintWriter (Channels.newWriter(socketChannel, UTF_8)); 

System.out .printin("Networking established.") ; 

catch (IOException e) { 


e.printStackTrace() ; : : from a w 
PrintWeiter 5 cake ‘Ch annel. 


server. 


writes 
} 
prg Rengo ve 
vimy 
private void sendMessage() { ually do the "ne anter keom 0; 
writer .printin (outgoing. getText ()); Now we abc! chame to we do à wy 
writer .flush () ; the aater ‘S e, so Y en to the server. 
outgoing .setText (""); Gotket norm the netwo k 
ing. tF F : es O 
} eee ero i 9° If you want to try this now, type in 
the Ready-bake chat server code 
public static void main(String[] args) { listed on the next page. 
new SimpleChatClientaA() .go(); First, start the server in one terminal. 


Next, use another terminal to start 
this client. 
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chat server code 


import 
import 
import 
import 
import 


import 


public 


Ready-Bake 
Code 


The really, really simple Chat Server 


You can use this server code for all versions of the Chat Client. Every possible disclaimer 
ever disclaimed is in effect here. To keep the code stripped down to the bare essentials, we 
took out a lot of parts that you’d need to make this a real server. In other words, it works, 
but there are at least a hundred ways to break it. If you want to really sharpen your skills 
after you've finished this book, come back and make this server code more robust. 


After you finish this chapter, you should be able to annotate this code yourself. You'll 
understand it much better if you work out what’s happening than if we explained it to you. 
Then again, this is Ready-Bake Code, so you really don’t have to understand it at all. It’s 
here just to support the two versions of the Chat Client. 


To run the Chat Client, you need two 
terminals. First, launch this server 
java.io.*; from one terminal, and then launch 
java.net .InetSocketAddress; the client from another terminal. 
java.nio.channels.*; 
java.util.*; 
java.util.concurrent.*; 


static java.nio.charset .StandardCharsets.UTF_8; 


class SimpleChatServer { 


private final List<PrintWriter> clientWriters = new ArrayList<>() ; 


public static void main(String[] args) { 
new SimpleChatServer() .go(); 


public void go() { 
ExecutorService threadPool = Executors .newCachedThreadPool () ; 
try { 
ServerSocketChannel serverSocketChannel = ServerSocketChannel.open () ; 
serverSocketChannel.bind(new InetSocketAddress (5000) ); 


while (serverSocketChannel.isOpen()) { 


} 


SocketChannel clientSocket = serverSocketChannel.accept () ; 

PrintWriter writer = new PrintWriter (Channels.newWriter(clientSocket, UTF_8)); 
clientWriters.add(writer) ; 

threadPool.submit (new ClientHandler (clientSocket) ) ; 

System.out .printin ("got a connection"); 


} catch (IOException ex) { 
ex.printStackTrace () ; 
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private void tellEveryone (String message) { 
for (PrintWriter writer : clientWriters) { 


writer.printl1n (message); 
writer.flush () ; 


public class ClientHandler implements Runnable { 


BufferedReader reader; 
SocketChannel socket; 


public ClientHandler (SocketChannel clientSocket) { 


socket = clientSocket; 


reader = new BufferedReader (Channels .newReader (socket, UTF_8)); 


public void run() { 
String message; 
try { 


while ((message = reader.readLine()) != null) { 
System. out .printiln ("read " + message); 


tellEveryone (message); 


} 
} catch (IOException ex) { 
ex.printStackTrace () ; 


| File Edit Window Help TakesTwoToTango 
% java SimpleChatServer 


got a connection 


read Nice to meet you 


Runs in the background 


| File Edit Window Help MaylHave This Dance? 
% java SimpleChatClientA 


Networking established. Client 
running at: /127.0.0.1:57531 


Connetts to the 


server and launches 


Gul 
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improving the chat client 


Version Two: se 
and receive 


ou te es 
] ican you tell me how to get to S 


~ udierousty Simple Ch 


2 
ameChicken street! 


eft. 
ALU! i y'i) take MY 
ots Soli like that one more time, 
if you S 


software and go home 


inComing, 
messages 


outgoing message 


or, abused, 
pprove of your overuse a the po! 
t al j ; 
ldo Emation mark. One A enoug 
Who's in here right now! 
DarkStar 
MuffinPerson 
aret up MuffinPerson? 
Wwho said that? 


at Client ee 


Send | 
i think it was Darkstat| S 


The Server sends a message to all 

client participants, as soon as the 

message is received by the server. 
When a tlient sends a message, it 
doesn't appear in the incoming 
message display area until the 
server sends it to everyone. 


Big Question: HOW do you get messages from the server? 


messages using readLine. 


Should be easy; when you set up the networking, make a Reader as well. Then read 


Bigger Question: WHEN do you get messages from the server? 


Think about that. What a 


re the options? 


age. 


© Option One: Read something in from the server each time the user 
sends a mess 


Pros: Doable, very easy. 


lurker and doesn’t send anything? 


Cons: Stupid. Why choose such an arbitrary time to check for messages? What if a user is a 


© Option Two: Poll the server every 20 seconds. 


Pros: It’s doable, and it fixes the lurker problem. 


Cons: How does the server know what you’ve seen and what you haven’t? The server would have 
to store the messages, rather than just doing a distribute-and-forget each time it gets one. And 


server needlessly. Inefficient. 


why 20 seconds? A delay like this affects usability, but as you reduce the delay, you risk hitting your 


© Option Three: Read messages as soon as they’re sent from the server. 
Pros: Most efficient, best usability. 


Cons: How do you do two things at the same time? Where would you put this code? You’d need 
a loop somewhere that was always waiting to read from the server. But where would that go? 
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Once you launch the GUI, nothing happens until an event is fired by a GUI component. 


You know by now that we’re 
going with option three 


We want something to run continuously, 
checking for messages from the server, but 
without interrupting the user’s ability to interact 
with the GUI! So while the user is happily 
typing new messages or scrolling through 
the incoming messages, we want something 
behind the scenes to keep reading in new input 
from the server. 


That means we finally need a new thread. A 
new, separate stack. 


We want everything we did in the Send-Only 
version (version one) to work the same way, 
while a new process runs alongside that reads 
information from the server and displays it in 
the incoming text area. 


Well, not quite. Each new Java thread is not 
actually a separate process running on the 
OS. But it almost feels as though it is. 


We're going to take a break from the chat 
application for a bit while we explore how 
this works. Then we'll come back and add it 
to our chat client at the end of the chapter. 
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In Java you really CAN 
walk and chew gum at 
the same time. 


Multithreading in Java 


Java has support for multiple threads built 
right into the fabric of the language. And it’s 
a snap to make a new thread of execution: 


Thread t = new Thread(); 
t.start (); 


That’s it. By creating a new Thread object, 
you've launched a separate thread of execution, 
with its very own call stack. 


Except for one problem. 


That thread doesn’t actually do anything, 
so the thread “dies” virtually the instant 
it’s born. When a thread dies, its new stack 
disappears again. End of story. 


So we’re missing one key component—the 
thread’s job. In other words, we need the 
code that you want to have run by a separate 
thread. 


Multiple threading in Java means we have to 
look at both the thread and the job that’s run 

by the thread. In fact, there’s more than 
one way to run multiple jobs in Java, 
not just with the Thread class in the java.lang 
package. (Remember, java.lang is the package 
you get imported for free, implicitly, and it’s 
where the classes most fundamental to the 
language live, including String and System.) 
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threads and Thread 


Java has multiple threads but only 
one Thread class 


We can talk about thread with a lowercase “t” and Thread 
with a capital “T.” When you see thread, we’re talking about 

a separate thread of execution. In other words, a separate 
call stack. When you see Thread, think of the Java naming 
convention. What, in Java, starts with a capital letter? Classes 
and interfaces. In this case, Thread is a class in the java.lang 
package. A Thread object represents a thread of execution. In 
older versions of Java, you always had to create an instance of 
class Thread each time you wanted to start up a new thread 
of execution. Java has evolved over time, and now using the 
Thread class directly is not the only way. We’ll see this in 
more detail as we go through the rest of the chapter. 


thread 


main thread another thread 
started by the code 


A thread (lowercase “t”) is a separate thread of execution. That 
means a separate call stack. Every Java application starts up a 
main thread—the thread that puts the main() method on the 
bottom of the stack. The JVM is responsible for starting the 
main thread (and other threads, as it chooses, including the 
garbage collection thread). As a programmer, you can write 
code to start other threads of your own. 
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A thread is a separate 
“thread of execution,” a 
separate cal] stack. 


A Thread is a Java class 


that represents a thread. 


Using the Thread class 
is not the only way to do 
multithreading in Java. 


Thread 


Thread 
void join() 
void start() 


static void sleep() 


java.lang.Thread 
class 


Thread (capital “T”) is a class that 
represents a thread of execution. It 
has methods for starting a thread, 
joining one thread with another, 
putting a thread to sleep, and more. 
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What does it mean to have more than 
one call stack? 


With more than one call stack, you can have multiple things happen at the same time. If 
you're running on a multiprocessor system (like most modern computers and phones), you can 
actually do more than one thing at a time. With Java threads, even if you’re not running on a 
multiprocessor system or if you’re running more processes than available cores, it can appear 
that you’re doing all these things simultaneously. In other words, execution can move back and 
forth between stacks so rapidly that you feel as though all stacks are executing at the same time. 
Remember, Java is just a process running on your underlying OS. So first, Java itself has to be 
“the currently executing process” on the OS. But once Java gets its turn to execute, exactly what 
does the JVM run? Which bytecodes execute? Whatever is on the top of the currently running 
stack! And in 100 milliseconds, the currently executing code might switch to a different method 
on a different stack. 


One of the things a thread must do is keep track of which statement (of which method) is 
currently executing on the thread’s stack. 


It might look something like this: 


The active thread 


@ The JVM calls the main() method. ļ 


public static void main(String[] args) { a 


eee main thread 
} 


A new thread starts 
and becomes the active 
main() starts a new thread. The main thread 


thread may be temporarily frozen while 


At OT, 
t.start 
the new thread starts running. 0 l 


i main() 
Runnable r = new MyThreadJob() ; 5 
Thraad-& = pay Threadi tj; ir f main thread user thread “t” 
t.start(); a< is ere 
Dog d = new Dog(); a moment... Jus 

l à agan 

The active en 
3) The JVM switches between the new ~ Do s x.go() 


thread (user thread A) and the original 
main thread, until both threads complete. 


| run() ) 


main thread user thread “t” 
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Runnable interface 


To create a new call stack you need a job to run 


All I need is a real job. 
Just give me a Runnable, 
and I'll get to work! 


Runnable is to a thread 
what a job is to a 
worker. A Runnable 

is the job a thread is 
supposed to run. 


A Runnable holds the 
method that goes on the 
bottom of the new cal] 
stack: run(). 


To start a new call stack the thread needs a job—a job the thread will run 
when it’s started. ‘That job is actually the first method that goes on the new 
thread’s stack, and it must always be a method that looks like this: 


nabl . 
public void run() { Tre Row vole, vor © ge, a netiond 
// code that will be run by the new thread method: N à ws a AM Tod instead 
OO) 
se ee, and YOn EAN Teme 
ce, s 
\nter a i shae elas 
How does the thread know which method to put at the bottom of the ok preating wa 
stack? Because Runnable defines a contract. Because Runnable is an Runnable fk you 


interface. A thread’s job can be defined in any class that implements the 
Runnable interface, or a lambda expression that is the right shape for the 
run method. 


Once you have a Runnable class or lambda expression, you can tell the 
JVM to run this code in a separate thread; you’re giving the thread its job. 
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To make a job for your thread, 
implement the Runnable interface guna is jn $e polos package 


, impor u 


L so you don 


public class MyRunnable implements Runnable { 


public void run() { 
oO; = Runnable has only one method to 
} implement: publi¢ void run() Gath no 


E rA This is where you put the 


public void go() { the thread is supposed to run. This 


Ə l doMore () ; i i goes at the bottom 
n) see the public void doMore() { 
We k Sor Anis System. out .printin (Thread.currentThread().getName() + 
stat Aon he ": top o’ the stack"); A owt veally need three 
thre Ves) Thread .dumpStack () ; This Runnable doe i call each other 
ext P29 } ’ tiny methods, which 2 demonstrate 
we ve gon wy } dum Sår were using 1E V vs tode 
PStaek wi like this; iii 
soraio a see just like an ates i current e all stack what i call stack running 
you the will show i ions stack trae Wao? looks like- 
winy over al us the Current stack Poe sing it here 
pane” adi Pe for debugging (it but you should 


How NOT to run the Runnable 


It may be tempting to create a new instance of the Runnable and call the run method, 
but that’s not enough to create a new call stack. 


class RunTester { 
public static void main(String[] args) { 
MyRunnable runnable = new MyRunnable() ; 
runnable.run() ; 
System. out .printin (Thread.currentThread().getName() + 
": back in main"); 


; Thread. dumpStack () ; This will NOT do what we want! 
— — 


} 


The run() method was called directly from 
inside the main() method, so it's part of - 
the call stack of the main thread. 


main thread 
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socket connections 


How we used to launch a new thread 


The simplest way to launch a new thread is with the Thread class that we 
mentioned earlier. This method has been around in Java since the very 
beginning, but it is no longer the recommended approach to use. 
We're showing it here because a) it’s simple, and b) you'll see it in the Real 
World. We will talk later about why it might not be the best approach. 


i nto the 
class ThreadTester { , 7 ow | 
ss sie patna rae ae 
ni ; | . 
thread what job $2 od will be the 


the Runnable s a is aes thread will vun- 


first method t 


public static void main(String[] args) { 


Runnable threadJob = new MyRunnable() ; 
Thread myThread = new Thread (threadJob) ; 


myThread. start () ; C ) 
(1) You won't get a new thread of ex 


, : Il startO ecution until 
d's System. out .print1n ( you ca rtl) on the Thr adj 
This Tes Thread.currentThread().getName() + 's not really a thread until on ae ft thread 
katk ` ": back in main"); at, Er a Thread instance, like oe 
Thread .dumpStack () ; object, but it won £ have any re al « tie beers 
ness. 


© 


main thread 


Now we have two 
independent call 
stacks. 


new thread 


il stack for the “main” Call stack for the new 
a of the oe thread we started with the 
(started by the puot J MyRunnable job. 


statie void main method). 


File Edit Window Help Duo 
%java ThreadTester 


jurepstaek? main: back in main 
ealed {rom Thread-0: top o’ the stack 
goMore \e java.lang.Exception: Stack trace 
MyRunnde e at java.base/java.lang.Thread.dumpStack (Thread. java:1383) 
at ThreadTester.main (MyRunnable.java:38) Note the 
java.lang.Exception: Stack trace main method 
at java.base/java.lang.Thread.dumpStack (Thread. java:1383) is NOT the 
dumpStaek0 a0 at MyRunnable.doMore (MyRunnable. java:15) bottom of 
talled trom mar at MyRunnable .go (MyRunnable.java:10) the eall 
; stack of the 
method at MyRunnable.run (MyRunnable. java: 6) Runnable 


at java.base/java.lang.Thread. run (Thread. java: 829) 
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A better alternative: don't manage the 
Threads at all 


Creating and starting a new Thread gives you a lot of control over that Thread, but the 
downside is you have to control it. You have to keep track of all the Threads and make sure 
they’re shut down at the end. Wouldn't it be better to have something else that starts, stops, and 


even reuses the Threads so you don’t have to? 


Allow us to introduce an interface in java.util.concurrent, 
ExecutorService. Implementations of this interface will execute jobs 
(Runnables). Behind the scenes the ExecutorService will create, reuse, and 
kill threads in order to run these jobs. 


The java.util.concurrent .Executors class has factory methods to 
create the ExecutorService instances we’ll need. 


Executors have been around since Java 5 and so should be available to you 
even if you’re working with quite an old version of Java. There’s no real 
need to use Thread directly at all these days. 


Kunning one job 

For the simple cases we’re going to get started with, we'll want to run only 
one job in addition to our main class. There’s a single thread executor that we 
can use to do this. 


Static factory methods 
can he used instead of 
constructors. 


Factory methods return 
exactly the implementation 
of an interface that we 
need. We don’t need to 
know the concrete classes 
or how to create them. 


3 Thread instante, use â 


class ExecutorTester { Instead of pa e = bo ake N 
e Ch 
public static void main(String[] args) { ee 


Runnable job = new MyRunnable(); 

ExecutorService executor = 

executor .execute (job) ; 
e 


Tell the ExecutorServiċe to th 
job. It will take care of stating a 
new thread for the job if it needs to. 


Executors .newSingleThreadExecutor () ; 


w In our Case, we only want 


to start a single | b, 
it’s logical to wee 
single thread executor. 


System.out.printin(Thread.currentThread().getName() + 


": back in main"); 
Thread. dumpStack () ; 
executor . shutdown () ; 
—_—_—===_— 


} he Ex etutorService 


hut down +! 
Remember hed with it \f you dont 


hut it down, the program will hang, around 
shu ? 


waiting for more y? S. 


We'll come back to the Executors 
factory methods later, and we'll 
see why it might be better to use 
ExecutorServices rather than 
managing the Thread itself. 
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The three states of a new thread 


Whether you create a new Thread and pass it the Runnable, or use an 


Executor to execute the Runnable, the job will still be running on a Thread. 
A Thread will move through a number of different states during its life, and 
understanding these states, and the transitions between them, helps us to 


better understand multithreaded programming. 


NEW 


A Thread instance has been 


created but not started. In other 
words, there is a Thread object, 


but no thread of execution. 


But there’s more. Once the thread becomes 
runnable, it can move back and forth between 
runnable, running, and an additional state: 


“I'm waiting to 
get started.” 


RUNNABLE 


When you start the thread, it 


moves into the runnable state. ‘This 
means the thread is ready to run 
and just waiting for its Big Chance 
to be selected for execution. At this 
point, there is a new call stack for 


this thread. 


temporarily not runnable. 
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thread 


This is ane a 


wants to be! 


« Can | 
supersize 
that for 


you?” 


This is the state all threads lust 
after! To be Up And Running. 
Only the JVM thread scheduler 
can make that decision. You can 
sometimes influence that decision, 
but you cannot force a thread to 
move from runnable to running. 
In the running state, a thread (and 
ONLY this thread) has an active 
call stack, and the method on the 
top of the stack is executing. 
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Typical runnable/running loop 


Typically, a thread moves back and forth 
between runnable and running, as the 

JVM thread scheduler selects a thread to 
run and then kicks it back out so another 


thread gets a chance. 


A thread can be made 


temporarily not-runnable 


The thread scheduler can move a 
running thread into a blocked state, for 
a variety of reasons. For example, the 
thread might be executing code to read 
from an input stream, but there isn’t 
any data to read. The scheduler will 
move the thread out of the running state 
until something becomes available. Or 
the executing code might have told the 
thread to put itself to sleep (sleep()). Or 
the thread might be waiting because 

it tried to call a method on an object, 
and that object was “locked.” In that 
case, the thread can’t continue until the 
object’s lock is freed by the thread that 
has it. 


All of those conditions (and more) cause 
a thread to become temporarily not- 
runnable. 


RUNNABLE RUNNING 


A Selected to run é 
e =e {3 
3 : 


Sent back to runnable 
so another thread can 
have a chance 


RUNNABLE RUNNING 


Sleeping, waiting for another thread to finish, 
waiting for data to be available on the stream, 
waiting for an object's loek... 


youare here» 617 


thread scheduling 


The thread scheduler 


The thread scheduler makes all the decisions about who 
moves from runnable to running, and about when (and 
under what circumstances) a thread leaves the running 

state. The scheduler decides who runs, for how long, and 
where the threads go when it decides to kick them out of the 


currently running state. 


You can’t control the scheduler. There is no API for calling Number four, you've had 


methods on the scheduler. Most importantly, there are enough time. Back to runnable. 
no guarantees about scheduling! (There are a few almost- Number two, looks like you're up! 


guarantees, but even those are a little fuzzy.) Gh now it oake tike youre gonna hove 


to sleep. Number five, come take his 
place. Number two, you're still 


The bottom line is this: do not base your program’s 

correctness on the scheduler working in a particular 
way! The scheduler implementations are different for ; 
different JVMs, and even running the same program on the sleeping... 
same machine can give you different results. One of the 
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worst mistakes new Java programmers make is to test 
their multithreaded program on a single machine, and 
assume the thread scheduler will always work that way, 
regardless of where the program runs. 


So what does this mean for write-once-run-anywhere? It 
means that to write platform-independent Java code, your 


The thread scheduler 
makes al] the 
decisions about who 
runs and who doesnt. 
It usually makes the 
threads take turns, 
nicely. But there’s no 
guarantee about that. 
It might let one thread 
run to its heart’s 
content while the 
other threads “starve.” 


multithreaded program must work no matter Aow the thread 
scheduler behaves. That means you can’t be dependent on, 
for example, the scheduler making sure all the threads take 
nice, perfectly fair, and equal turns at the running state. 
Although highly unlikely today, your program might end up 
running on a JVM with a scheduler that says, “OK, thread 
five, you’re up, and as far as I’m concerned, you can stay 
here until you’re done, when your run() method completes.” 
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An example of how unpredictable the 
scheduler can be... 


Runnable presented 38 2 
a 


ta i 
and ession: Our Je java ExecutorTestDrive 
lambda an at tode, $° a J 
a single Tne akes sense here: back in main 


class ExecutorTestDrive { 
public static void main (String[] args) { 
ExecutorService executor = java ExecutorTestDrive 
Executors .newSingleThreadExecutor () ; 


top o’ the stack 


top o’ the stack 


executor.execute(() -> back in main 

5 Ww r Ww . 

System.out .printin ("top o’ the stack")); java ExecutorTestDrive 
System.out.printin("back in main"); top o’ the stack 

executor. shutdown () ; 


} 


back in main 


java ExecutorTestDrive 


he new ; 

etimes t . ain ; l 

anen and sometimes the m back in main 
bhead finishes fist. top o’ the stack 


java ExecutorTestDrive 


top o’ the stack 


It doesn't matter if you run this 
using an Executor Service, like 

the code above, or with Threads 
directly, like the code below; both 
show the same symptoms. 


back in main 


java ExecutorTestDrive 


top o’ the stack 


back in main 


java ExecutorTestDrive 


back in main 


top o’ the stack 


class ThreadTestDrive { 
public static void main (String[] args) { 
Thread myThread = new Thread(() -> 
System.out.println("top o’ the stack")); 
myThread. start () ; 
System.out.println ("back in main"); 


} 
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How did we end up with different results? 


Multithreaded programs are not deterministic; they don’t run the same way every time. The 
thread scheduler can schedule each thread differently each time the program runs. 


Sometimes it runs like this: 


main() starts the The scheduler sends The scheduler lets The new thread goes 
new job running. the main thread out the new threadrun | away, because it has 
of running and back to completion, print-| finished the job. The 
to runnable, so that ing out “top o’ the main thread once again 
the new thread can stack.” becomes the running 
run. thread and prints “back 
in main.” 
executor exec executor .executel ji 
main | = main() ) TA) it -e , 
main thread main thread new thread main thread 
time 


And sometimes it runs like this: 


main() starts the The scheduler sends The scheduler lets the] The scheduler The scheduler The new thread returns 
new thread. the main thread out new thread run, but sends the new selects the main to the running state 
of running and back not long enough to thread back to thread to be the and prints out “top o' 
to runnable, so that complete everything. | runnable. running thread the stack.” 
the new thread can again. Main prints 
run. out “back in main.” 
aE 
executor exec executor. executes ds 
m eoa —e—_! = | Gas) 
main thread main thread new thread new thread main thread new thread 
time 


Even $f the new thread is tiny, if it has only one line 
of code to run like our lambda expression, it can stil] 
he interrupted by the thread scheduler. 
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there, are no 


Dumb Questions 


Q: Should I use a lambda expression for my 
Runnable or create a new class that implements 
Runnable? 


A: It depends upon how complicated your 

job is, and also on whether you think it's easier to 
understand as a lambda expression or a class. 
Lambda expressions are great for when the job 

is really tiny, like our single-line “print” example. 
Lambda expressions (or method references) may 
also work if you have a few lines of code in another 
method that you want to turn into a job: 


executor.execute(() -> printMsg() ) ; 


You'll most likely want to use a full Runnable class 
if your job needs to store things in fields and/or if 
your job is made up of a number of methods. This 
is more likely when your jobs are more complex. 


|? What's the advantage of using an 
ExecutorService? So far, it works the same as 
creating a Thread and starting it. 


A: It’s true that for these simple examples, 
where we're starting just one thread, letting 

it run, and then stopping our application, the 

two approaches seem similar. ExecutorServices 
become really helpful when we're starting lots of 
independent jobs. We don’t necessarily want to 
create a new Thread for each of these jobs, and we 
don’t want to keep track of all these Threads. There 
are different ExecutorService implementations 
depending upon how many threads we'll want 

to start (or especially if we don’t know how many 
Threads we'll need), including ExecutorServices 
that create Thread pools. Thread pools let us reuse 
Thread instances, so we don't have to pay the cost 
of starting up new Threads for every job. We'll 
explore this in more detail later. 
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BULLET POINTS 


A thread with a lowercase “t” is a separate thread of execution 
in Java. 


Every thread in Java has its own call stack. 


A Thread with a capital “T” is the java.lang. Thread class. A 
Thread object represents a thread of execution. 


A thread needs a job to do. The job can be an instance of 
something that implements the Runnable interface. 


The Runnable interface has just a single method, run(). This 
is the method that goes on the bottom of the new call stack. In 
other words, it is the first method to run in the new thread. 


Because the Runnable interface has just a single method, you 
can use lambda expressions where a Runnable is expected. 


Using the Thread class to run separate jobs is no longer the 
preferred way to create multithreaded applications in Java. 
Instead, use an Executor or an ExecutorService. 


The Executors class has helper methods that can create 
standard ExecutorServices to use to start new jobs. 


A thread is in the NEW state when it has not yet started. 


When a thread has been started, a new stack is created, with 
the Runnable’s run() method on the bottom of the stack. The 
thread is now in the RUNNABLE state, waiting to be chosen 
to run. 


A thread is said to be RUNNING when the JVM’s thread 
scheduler has selected it to be the currently running thread. 
On a single-processor machine, there can be only one 
currently running thread. 


Sometimes a thread can be moved from the RUNNING state 
to a temporarily NON-RUNNABLE state. A thread might be 
blocked because it's waiting for data from a stream, because it 
has gone to sleep, or because it is waiting for an object's lock. 
We'll see locks in the next chapter. 


Thread scheduling is not guaranteed to work in any particular 
way, SO you cannot be certain that threads will take turns 
nicely. 
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Putting a thread to sleep 


One way to help your threads take turns is to put them to 
sleep periodically. All you need to do is call the static sleep() 


method, passing it the amount of time you want the 
A thread to sleep for, in milliseconds. 
A For example: 


Thread. sleep (2000) ; 


will knock a thread out of the running state and keep 
it out of the runnable state for two seconds. The 
thread cant become the running thread again until 
after at least two seconds have passed. 


A bit unfortunately, the sleep method throws an 
InterruptedException, a checked exception, so all calls 
to sleep must be wrapped in a try/catch (or declared). 
So asleep call really looks like this: 


try { 
Thread.sleep (2000) ; 

} catch (InterruptedException ex) { 
ex.printStackTrace () ; 


} 


Now you know that your thread won’t wake up before 
the specified duration, but 1s it possible that it will wake up 
some time afier the “timer” has expired? Effectively, yes. The 
thread won’t automatically wake up at the designated time 
and become the currently running thread. When a thread 
wakes up, the thread is once again at the mercy of the thread 
scheduler; therefore, there are no guarantees about how long 
the thread will be out of action. 


Putting a thread to 
sleep gives the other 
threads a chance to 
run. 


When the thread wakes 
up, it always goes back 
to the runnable state 
and waits for the thread 
scheduler to choose it 
to run again. 


It can be hard to understand how much time 
a number of milliseconds represents. There's a 
convenience method on java.util.concurrent. 
TimeUnit that we can use to make a more 
readable sleep time: 


TimeUnit .MINUTES.sleep (2) ; 


which may be easier to understand than: 


Thread.sleep (120000) ; 


(You still need to wrap both in a try-catch, 


though.) 
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Using sleep to make our program 
more predictable 


Remember our earlier example that kept giving us different results 
each time we ran it? Look back and study the code and the sample 
output. Sometimes main had to wait until the new thread finished 
(and printed “top o’ the stack”), while other times the new thread 
would be sent back to runnable before it was finished, allowing 
the main thread to come back in and print out “back in main.” 
How can we fix that? Stop for a moment and answer this question: 
“Where can you put a sleep() call, to make sure that “back in main’ 
always prints before “top o° the stack”? 


class PredictableSleep { 
public static void main (String[] args) { 
ExecutorService executor 
Executors .newSingleThreadExecutor () ; 
executor.execute(() -> sleepThenPrint ()) ; 
System.out.printin("back in main"); 
executor. shutdown () ; 


} 


private static void sleepThenPrint() { 
try { 
TimeUnit . SECONDS .sleep (2) ; 
} catch (InterruptedException e) { 
e.printStackTrace () ; 
} 
System.out.printlin("top o’ the stack"); 


} 
} 
TI 3 

Thwread.sleepl) throws a cheiked ee a Pause 

; eed Wo 
elie eee, tien 
or . b b's tode a À IS ine, which 

seeption makes the jon s Co pris, line, v 

an ees we've put it in ners ene top o’ the 


method. 
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This is what we want—a Consistent order 
of print statements: 


java PredictableSleep 


back in main 


top o’ the stack 
java PredictableSleep 
back in main 


top o’ the stack 


java PredictableSleep 
back in main 

top o’ the stack 
java PredictableSleep 
back in main 


top o’ the stack 


java PredictableSleep 


back in main 


top o’ the stack 


Instead of i 

puttin m i 
B inside, raed seb 
method. We're calling t 


€XPression. 


th an l 
job ode es y- 


he method from this lambda 


sleep here will f 


Calling 


to print out “back in main: 


=) 
Brain Barbell 


Can you think of any problems with forcing your 
threads to sleep for a set amount of time? How 


long will it take to run this code 10 times? 
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There are downsides to forcing 
the thread to sleep 
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@ The program has to wait for at least that amount of time. 


If we put the thread to sleep for two seconds, the thread will be non-runnable for that time. 
When it wakes up, it won’t automatically become the currently running thread. When a thread 
wakes up, the thread is once again at the mercy of the thread scheduler. Our application is go- 
ing to be hanging around for at least those two seconds, probably more. This might not sound 
like a big deal, but imagine a bigger program full of these pauses intentionally slowing down the 
application. 


@ How do you know the other job will finish in that time? 


We put the new thread to sleep for two seconds, assuming that the main thread would be the 
running thread, and complete its work in that time. But what if the main thread took longer to 
finish than that? What if another thread, running a longer job, was scheduled instead? One of 
the ways people deal with this is to set sleep times that are much longer than they’d expect a 
job to take, but then our first problem becomes even more of a problem. 


Is there a way for one thread to tell another 
that it has finished what it's working on? That 
way, the main thread could just wait for that 

signal and then carry on when it knows it's safe 
to go. 


A better alternative: wait for the perfect time. 


What we really wanted in our example was to wait until a specific thing had 
happened in our main thread before carrying on with our new thread. Java 
supports a number of different mechanisms to do this, like Future, CyclicBarrier, 
Semaphore, and CountDownLatch. 


> 


To coordinate events happening on multiple 
threads, one thread may need to wait for a 
specific signal from another thread before it 


can continue. 
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Counting down until ready 
CountDownLatch is a 
harrier synchronizer. 
continuing. You might be counting down until a minimum number of Barri ers are me chanis ms 


clients have connected, or a number of services have been started. 


This is what java.util.concurrent .CountDownLatch is for. to allow threads to co- 
You set a number to count down from. Then any thread can tell the latch ordinate with each other. 


to count down when a relevant event has happened. 
In our example, we have only one thing we want to count—our new Other examples are 
thread should wait until the main thread has printed “back in main” Cycli cBarri er an d Phas er 


You can make threads count down when significant events have happened. 
A thread (or threads) can wait for all these events to complete before 


before it can continue. 


import java.util.concurrent.*; 

class PredictableLatch { 
public static void main (String[] args) { lets us Wai f This lateh 

ExecutorService executor = Executors.newSingleThreadExecutor () ; We hay, or the signal.” 


e one 
CountDownLatch latch = new CountDownLatch (1) ; < to wait i. TE we want 


€ main thread 


executor.execute(() -> waitForLatchThenPrint (latch)); this uP with a 9 af we set 
Ve ue o. j» 
l : ! ayi kne n 9 
System.out.println("back in main"); Pass cen Bt o kp 
latch. countDown () ; tt? Bs oon) 


Ne Tell the latch to Count down when the e y N pa 


executor .shutdown (); main method has rinted i o 
message. yun 


private static void waitForLatchThenPrint (CountDownLatch latch) { Thi 
. its message. is 
por await (); Z Wait for the main thread to nines ey it’s Ja 
: R : 
} catch (InterruptedException e) { thread will be in a non—runnd 


e.printStackTrace(); await() tan thr 
OW an 


Interrupt, 
PtedEx¢ept; 
e Caught or Fv Wee 


} 
System.out.printlin("top o” the stack"); 
} 


arved. neh needs to 


} 

The code is really similar to the code that performs a sleep; the main difference is the 
latch.countDown in the main method. The performance difference is significant, though. 
Instead of having to wait at least two seconds to make sure main has printed its message, 
the new thread waits only until the main method has printed its “back in main” message. 


To get an idea of the performance difference this might make on a real system, when 
this latch code was run on a MacBook 100 times, it took around 50 milliseconds to finish 
all one hundred runs, and the output was in the correct order every time. If running the 
sleep() version just one time takes over 2 seconds (2000 milliseconds), imagine how long it 
took to run 100 times*.... 


* 200331 milliseconds. That’s over 4000x slower. 
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starting multiple threads 


Making and i 
s 
(or morel) tarting two threads 


What h 
appens if we 
want to s 
tart more than one job in additi 
on to our mat 
n thread? 


Clearl 
Y, WE can’t us 

e Exe : 
than one cutors.newS 

thread. Wh ingleThre dE 
. What else is avai adExecutor() if 
ilable? if we want to 
$ run more 


java.util.concurrent-Executo t (Just a few of the 
factory methods) 


ExecutorService newCcachedThreadPool() 


Creates a thread pool that creates new threads as needed, but will reuse 
previously constructed threads when they are available. 


ExecutorService newFixedThreadPoollint nthreads) 


Creates a thread pool that reuses a fixed number of threads operating 
offa shared unbounded queue. 


gcheduledExecutorservice newScheduledThreadPool(int corePoolsize) 


Creates a thread pool that can schedule commands to run after a 
given delay, or to execute periodically. 


ExecutorService newsingleThreadexecutor' 


Creates an Executor that uses a single worker thread operating off an 
unbounded queue. 


gcheduledExecutorservice ewsinglethreadscheduledExecutor 


Creates a single-threaded executor that can schedule commands to run 
after a given delay, or to execute periodically. 


ExecutorService newWorkStealingPool() 


Creates a work-stealing thread pool using the number of available processors 
as its target parallelism level. 


These 
Koi ana i i at can be used (and reused) top kari 
jobs 4o Fen than pa < the pool, and what to do if th jobs. 
implementation. ads available, depends on the Exacuortondao 
ice 
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Pooling Threads 


Using a pool of resources, especially ones that are expensive to create like Threads or 
database connections, is a common pattern in application code. 
Lain one or more 


A thread pool- This Can X addled used, reused, 


| 
can be 
iw w cee killed according o whatever 
ne ‘the thread pool was set vp 


When you create a new ExecutorService, its pool 
may be started with some threads to begin with, or 
the pool may be empty. 


You can create an ExecutorService with a thread 
pool using one of the helper methods from the 
Executors class. 

ExecutorService threadPool = 


The threads available for running jobs. E me ern eer! 
ow many threads are allowed aa how 


they are used is determined by the pool. 


This Thread is idle. 


This Thread has been 


z 4 assigned 3 job to wun 


You can use the pool's threads to run your job 
by giving the job to the ExecutorService. The Ex- 
ecutorService can then figure out if there’s a free 
Thread to run the job. 


threadPool.execute(() -> run("Job 1")); 


This means an ExecutorService can reuse threads; 
it doesn’t just create and destroy them. 


tad As you give the ExecutorService more jobs to run, 
s Assigned a job it may create and start new Threads to handle the 
ol 


jobs. It may store the jobs in a queue if there are 
mmm Ta A , more jobs than Threads. 
x 3 y a OF How an ExecutorService deals with additional jobs 
X depends on how it is set up. 
threadPool.execute(() -> run("Job 324")); 
The ExecutorService may also terminate Threads 


= that have been idle for some period of time. This 


New Threads created to deal can help to minimize the amount of hardware 
with all the new jobs resources (CPU, memory) your application needs. 
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Running multiple threads 


The following example runs two jobs, and uses a fixed-sized thread pool to 
create two threads to run the jobs. Each thread has the same job: run in a 
loop, printing the currently running thread’s name with each iteration. 


import java.util.concurrent .ExecutorService; 


import java.util.concurrent.Executors; Ceyvite with 3 
m Exetv (we know 
public class RunThreads { oo pa read ane yo s 
Kea— on 
Ne going to en 
public static void main(String[] args) { 4- wer 


ExecutorService threadPool = Executors.newFixedThreadPool (2) ; 
threadPool.execute(() -> runJob("Job 1") ) i> . 
threadPool.execute(() -> runJob ("Job 2")) RL A lambda expression that represents our 


threadPool. shutdown () ; eee as lf you don’t want to use 
} ambdas, here you'd Pass in a new instante 
of your Runnable class, like we did when we 
public static void runJob(String jobName) { treated MyRunnable earlier in the chapter. 


for (int i = 0; i < 25; i++) { 
String threadName = Thread.currentThread() .getName () ; 
System. out.printin(jobName + " is running on " + threadName) ; 


l i 
h this loop» 
} zob is to vun throug) P 
Penn the thread's name each Lime 


Part of the output wh 
output when ; 
the loop iterates 25 times T java RunThreads 


that this means they will complete in the same amount Job is running pool-1-thread-1 


of time or output values at the same rate. Job 
Job 
Job 
Job 


Job 


is running pool-1-thread-1 
is running pool-1-thread-1 
is running pool-1-thread-1 
is running pool-1-thread-1 


Wh t ill h ? Job 1 is running pool-1-thread-1 
a wi appen Job 2 is running pool-1-thread-2 
Will the threads take turns? Will you see the thread Job 2 is running pool-1-thread-2 
names alternating? How often will they switch? With Job 1 is running pool-1-thread-1 
each iteration? After five iterations? Job 2 is running pool-1-thread-2 
You already know the answer: we domt know! It’s up to Job 1 is running pool-1-thread-1 
the scheduler. And on your OS, with your particular Job 2 is running pool-1-thread-2 
JVM, on your CPU, you might get very different results. Job 1 is running pool-1-thread-1 
Running this on a modern multicore system, the two Job 2 is running pool-1-thread-2 
jobs will likely run in parallel, but there’s no guarantee Job 1 is running pool-1-thread-1 

1 

1 

1 

1 

1 

1 


is running pool-1-thread-1 
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Closing time at the thread pool 


You may have noticed that our examples have a threadPool . shutdown() at the end of the 
main methods. Although the thread pools will take care of our individual Threads, we do need 
to be responsible adults and close the pool when we’re finished with it. That way, the pool can 
empty its job queue and shut down all of its threads to free up system resources. 


ExecutorService has two shutdown methods. You can use either, but to be safe we’d use both: 


@ ExecutorService.shutdown() 
Calling shutdown() asks the ExecutorService nicely if it wouldn’t mind awfully wrapping things up 


so everyone Can gO home. 


All of the Threads that are currently running jobs are allowed to finish those jobs, and any jobs 


waiting in the queue will also be finished off. The ExecutorService will reject any new jobs too. 


If you need your code to wait until all of those things are finished, you can use awaitTermination 
to sit and wait until it’s finished. You give await Termination a maximum amount of time to wait for 
everything to end, so awaitTermination will hang around until either the ExecutorService has 
finished everything or the timeout has been reached, whichever is earlier. 


@ ExecutorService.shutdownNow() 


Everybody out! When this is called, the ExecutorService will try to stop any Threads that are 
running, will not run any waiting jobs, and definitely won’t let anyone else into the pool. 


Use this if you need to put a stop to everything. This is sometimes used after first calling shutdown() 
to give the jobs a chance to finish before pulling the plug entirely. 


public class ClosingTime { 
public static void main(String[] args) { 
ExecutorService threadPool = Executors.newFixedThreadPool (2) ; 


re { hr a Ool w h us WO hrea S. 


Se : : 
Ak the ee a call threadPool.execute (new ShortJob("Short Job") ) , just oe es a sleep so it can 


that 
he shut. down Me one be a long-running 
exeeucel, wee A get ð threadPool . shutdown () ; nee a må ShortJob ie 
alter E eevbione RU 7 ee bat implement Runnable ` 
evel wee wi try { 
T v EretutorSen the jobs boolean finished = threadPool.awaitTermination(5, TimeUnit.SECONDS) ; 
gontinue yun and vun arny System.out.println("Finished? " + finished) ; Wait 
that ave soon } catch (InterruptedException e) { Eos L to 5 Setonds for th 
waitin, Jo s e.printStackTrace () ; pie thing Tht to Finish $ 
} the lig his method hits 
threadPool.shutdownNow () ; hà f neout before everythi 
A bpjs point, we tell the ExetuborServite to sto? ` Finished, it returns “ford 
} At pare gee now. |E everything, was already shu alse. 
n ; ` 
FER thot’ fine; this won t do anything; 
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aren’t threads wonderful? 


Wow! Threads are 
the greatest thing since the 
MINTI Cooper! I can't think 
of a single downside to using 
threads, can you? 


Um, yes. There IS a dark side. 
Multithreading can lead to 


concurrency “issues.” 


Concurrency issues lead to race conditions. Race conditions 
lead to data corruption. Data corruption leads to fear...you 
know the rest. 


It all comes down to one potentially deadly scenario: two or 
more threads have access to a single object’s data. In other 
words, methods executing on two different stacks are both 
calling, say, getters or setters on a single object on the heap. 


It’s a whole “left-hand-doesn’t-know-what-the-right-hand- 
is-doing” thing. Two threads, without a care in the world, 
humming along executing their methods, each thread 
thinking that he is the One True Thread. The only one 
that matters. After all, when a thread is not running, and in 
runnable (or blocked) it’s essentially knocked unconscious. 
When it becomes the currently running thread again, it 
doesn’t know that it ever stopped. 
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— BULLET POINTS 


The static Thread.sleep() method forces 
a thread to leave the running state for at 
least the duration passed to the sleep 
method. Thread.sleep(200) puts a thread 
to sleep for 200 milliseconds. 


You can also use the sleep method on 
java.util.concurrent. TimeUnit, for example 
TimeUnit. SECONDS. sleep(2). 


The sleep() method throws a checked 
exception (InterruptedException), so all 
calls to sleep() must be wrapped in a try/ 
catch, or declared. 


There are different mechanisms to give 
threads a chance to wait for each other. 
You can use sleep(), but you can also 
use CountDownLatch to wait for the right 
number of events to have happened 
before continuing. 


Managing threads directly can be a lot 

of work. Use the factory methods in 
Executors to create an ExecutorService, 
and use this service to run Runnable jobs. 


Thread pools can manage creation, reuse, 
and destruction of threads so you don’t 
have to. 


ExecutorServices should be shut down 
correctly so the jobs are finished and 
threads terminated. Use shutdown() for 
graceful shutdown, and shutdownNow() to 
kill everything. 


» } It’s a cliff-hanger! 
A dark side? Race condi- 
tions?? Data corruption?! 
But what can we DO about 
those things? Don't leave us 
hanging! 


Stay tuned for the next chapter, where we address 
these issues and more... 


networking and threads 


Exercise 


A bunch of Java and network terms, in full costume, are playing 

a party game, “Who am |?” They'll give you a clue—you try to 
guess who they are based on what they say. Assume they always 
tell the truth about themselves. If they happen to say something 
that could be true for more than one attendee, then write down 

all for whom that sentence applies. Fill in the blanks next to the 
sentence with the names of one or more attendees. 


1 


Tonight’s attendees: 


InetSocketAddress, SocketChannel, IP address, host name, 
port, Socket, ServerSocketChannel, Thread, thread pool, 
Executors, ExecutorService, CountDownLatch, Runnable, 
InterruptedException, Thread.sleep() 


| need to be shut down or | might live forever 
| let you talk to a remote machine 


| might be thrown by sleep() and await() 


If you want to reuse Threads, you should use me 


You need to know me if you want to connect to another 
machine 


I’m like a separate process running on the machine 
| can give you the ExecutorService you need 
You need one of me if you want clients to connect to me 


| can help you make your multithreaded code more 
predictable 


| represent a job to run 


| store the IP address and port of the server 


——— Answers on page 636. 
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final chat client 


New and improved SimpleChatClient 


Way back near the beginning of the chapter, we built the SimpleChatClient that could send outgoing 
messages to the server but couldn’t receive anything. Remember? That’s how we got onto this whole 
thread topic in the first place, because we needed a way to do two things at once: send messages to 


the server (interacting with the GUI) while simultaneously reading incoming messages from the server, 


displaying them in the scrolling text area. 


This is the New Improved chat client that can both send and receive messages, thanks to the power of 
multithreading! Remember, you need to run the chat server first to run this code. 


import javax.swing.*; 

import java.awt.*; 

import java.awt.event.*; 

import java.io.*; 

import java.net .InetSocketAddress; 
import java.nio.channels.*; 

import java.util.concurrent.*; 


import static java.nio.charset .StandardCharsets.UTF_8; 


public class SimpleChatClient { 
private JTextArea incoming; 
private JTextField outgoing; 
private BufferedReader reader; 
private PrintWriter writer; 


public void go() { 
setUpNetworking () ; 


JScrollPane scroller = createScrollableTextArea () ; 
outgoing = new JTextField(20) ; 


JButton sendButton = new JButton ("Send") ; 
sendButton.addActionListener(e -> sendMessage() ) ; 


JPanel mainPanel = new JPanel (); 
mainPanel.add(scroller) ; 
mainPanel .add (outgoing) ; 
mainPanel.add(sendButton) ; 


Yes, there really IS 
end to this ee ae 


But not yet. 


ve seen 
This is mostly ae ve eret vi 


2) 
is ve got a new job, an inner 
Class, which is a Re 


The job is to read from 
e server's socket stream, 


display; A : 
ExecutorService executor = Executors.newSingleThreadExecutor () ; P zing any inomin 


executor .execute (new IncomingReader () ) ; 


messages in the serollin 
text area. We start this 


io : ' 
JFrame frame = new JFrame("Ludicrously Simple Chat Client"); Soa a single thread 
frame .getContentPane() .add(BorderLayout.CENTER, mainPanel) ; Pa utor since we know we 


frame.setSize(400, 350); 
frame.setVisible (true) ; 


nt to run only this one job. 


frame .setDefaultCloseOperation (WindowConstants .EXIT_ON_CLOSE) ; 
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private JScrollPane createScrollableTextArea() { 


like we 
incoming = new JTextArea(15, 30); A helper sare ter |b, 
incoming. setLineWrap (true) ; saw back in vi ¥ he x4 area 
incoming .setWrapStyleWord (true) ; eveate a strolling 


incoming .setEditable (false); 


JScrollPane scroller = new JScrol1lPane (incoming) ; 


scroller .setVerticalScrol1l1BarPolicy (Scro11PaneConstants .VERTICAL_SCROLLBAR_ALWAYS) ; 


scroller .setHorizontalScrollBarPolicy (Scro11PaneConstants . HORIZONTAL_SCROLLBAR_NEVER) ; 
return scroller; 


private void setUpNetworking() { 
try { 


InetSocketAddress serverAddress = new InetSocketAddress ("127.0.0.1", 5000); 
SocketChannel socketChannel = SocketChannel.open (serverAddress) ; 


reader = 


new BufferedReader (Channels .newReader (socketChannel, UTF_8)); 
writer = 


new PrintWriter (Channels .newWriter(socketChannel, UTF_8)); 


System.out.println ("Networking established.") ; We're using, Channels aed tha ’s 
} catch (IOException ex) { md writer tor the ne The we ev sends 
ex.printStackTrace() ; connette a a and now we re using 
J menage te Fet e veader jeb tan 9° 
oe rom the server: 
private void sendMessage() { 


writer .println (outgoing. getText ()); 
writer .flush () ; 


Nothing new here. When 


the user éli 
outgoing.setText (""); the send button, this method ai 
outgoing. requestFocus () ; contents of the text field to the server. 
} 


public class IncomingReader implements Runnable { 
public void run() { 


String message; 


> This is what the thread does!! 
while ((message = reader.readLine()) != null) { e ee P 
System. out .print1n ("read " + message); te me un method 4 ay va 
a a a eo \ooẸ (as long as wha ) dint a 
| the server 1s not null . oe 
} catch (IOException ex) { line at a time and ad nd om 
ex.printStackTrace() ; ne one a = 
| with a new line character’: 
} 


public static void main(String[] args) { 
new SimpleChatClient () .go(); 


Remember, the Chat Server code was 
the Ready-Bake Code from page 606. 
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exercise: code magnets 
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———> Answers on page 636. 


chapter 17 


Code Magnets 


A working Java program is scrambled up on the fridge (see 
the next page). Can you reconstruct the code snippets on the 
next page to make a working Java program that produces the 
output listed below? 


To get it to work, you will need to be running the 
SimpleChatServer from page 606. 


File Edit Window Help StillThere 


% java PingingClient 

Networking established 
09:27:06 Sent ping 0 

09:27:07 Sent ping 
09:27:08 Sent ping 
09:27:09 Sent ping 
09:27:10 Sent ping 
09:27:11 Sent ping 
09:27:12 Sent ping 
09:27:13 Sent ping 
09:27:14 Sent ping 
09:27:15 Sent ping 


1 
2 
3 
4 
5 
6 
7 
8 
9 
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Code Magnets, continued 


{ 
} catch (IOException | InterruptedException e) 


ke 
cata 


import 
import java.net.InetSocketAddress; 
import java.nio.channels.*; 

import java.time.format.FormatStyle; 


import util.concurrent.TimeUnit; 


i < 10; i++) { 


System out p 
. . Tintin (currentTime + Sent + mess ge); 
a VF 


Inet SocketAddress server 


new Inet SocketAddre y 
ss ( 127.0.0.1", 5000); 


System.out.printin("Networking established"); 


public static void main(String [] args) J 


format (ofLocalizedTime (Fo 


TimeUnit .SECONDS.sleep (1); 


rmatStyle.MEDIUM) ) i 
= now() 


String currentTime 
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exercise solutions 


Who Am I? (from page 631) 


| need to be shut down or | might live forever ExeeutorService Exercise Solutions 
| let you talk to a remote machine SotketChannel, Socket 

| might be thrown by sleep() and await() InterruptedException 

If you want to reuse Threads, you should use me Thread pool, ExeeutorService 

You need to know me if you want to connect to another machine |P Addvess, Host name, port 

I’m like a separate process running on the machine Thread 

| can give you the ExecutorService you need Exeeutors 

You need one of me if you want clients to connect to me ServerSoeketChannel 


| can help you make your multithreaded code more predictable Thread -sleep(), CountDownLatch 


| represent a job to run Runnable 

| store the IP address and port of the server InetSoeket Address 
import java.io.*; 
import java.net .InetSocketAddress; C d M t 
import java.nio.channels.*; ode agne S 
import java.time. format .FormatStyle; (from pages 634-635) 


import java.util.concurrent.TimeUnit; 


import static java.nio.charset.StandardCharsets.UTF_8; 
import static java.time.LocalDateTime.now; 
import static java.time.format .DateTimeFormatter.ofLocalizedTime; 


public class PingingClient { 


public static void main(String[] args) { 
InetSocketAddress server = new InetSocketAddress ("127.0.0.1", 5000); 
try (SocketChannel channel = SocketChannel.open(server)) { 
PrintWriter writer = new PrintWriter (Channels.newWriter(channel, UTF_8)); 
System.out.println ("Networking established"); ¢ getting the 


for (int 

You should get the, string 
‘ . 

kout even writer. 

same ee a, een” to writer. 

“i eshe e ese WCE String 

some System. 
this Lor look A 


e.printStackTrace () ; 


} 


AAS Oe te att) A eurrent Lime an the Lorma 
message = "ping " + i; wto a Styring m 'Cetonds 
printin (message) ; at Yours: Minutes 


flush () ; 
currentTime = now() . format (ofLocalizedTime (FormatStyle.MEDIUM) ) ; 
out .printin(currentTime + " Sent " + message); 


TimeUnit . SECONDS .sleep (1) ; 


h la 
} catch (IOException | InterruptedException e) { : ie, te d r a | 
Can Side th io a 
Catehin all Exceptions at end sateh all 4 i for loop, pa by 
: th Extep4 Yo 
the end because we do the € metho CEP te, 3 i 
same thing with them all. I iie 
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* X 
x Code Kitchen Your message gets sent to 


*% pattern when Yo" ii 


fe ee Cyber BeatBox 


Bass Drum 


Closed Hi-Hat 


Open Hi-Hat 


Acoustic Snare 


Tempo Up 


Crash Cymbal Tempo Down 


Hand Clap sendit 
High Tom 

Hi Bongo 

Maracas 
Whistle 

Low Conga 

Cowbell 

Vibraslap MorganMove: groove2 revised 
Low-mid Tom 


dance beat 


SamSampler: groove #2 


BoomTish: dance beat 
High Agogo 


Open Hi Conga 


"essages fy 
Now you've seen how to build a chat client, we have P ras one to er 
the last version of the BeatBox! Wie. that goes 
m » and then liek 
It connects to a simple MusicServer so that you can lay it. 


send and receive heat patterns with other clients. 


The code is really long, so the complete listing 1s 
actually in Appendix A. 
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18 race conditions and immutable data 


Dealing with 
Concurrency Issues 


Dave hasn't noticed 
that Helen is taking bites out of 
his sandwich while he's eating it! 
Those two should figure out they're 
sharing something, or it's going to 
get messy... 


Doing two or more things at once is hard. writing multithreaded code is 
easy. Writing multithreaded code that works the way you expect can be much harder. In this 
final chapter, we're going to show you some of the things that can go wrong when two or more 
threads are working at the same time. You'll learn about some of the tools in java.util.concurrent 
that can help you to write multithreaded code that works correctly. You'll learn how to create 
immutable objects (objects that don’t change) that are safe for multiple threads to use. By the 


end of the chapter, you'll have a lot of different tools in your toolkit for working with concurrency. 


this is a new chapter 639 


concurrency issues 


What could possibly go wrong? 


At the end of the last chapter we hinted that things may not all be rainbows and sunshine when you’re 
working with multithreaded code. Well, actually, we did more than hint! We outright said: 


640 


“It all comes down to one potentially deadly 
scenario: two or more threads have access to a 
single object’s data.” 
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i 


E y 


Why is it a problem if two threads are both 
reading and writing? 


If a thread reads the object's data before changing 
it, why is ita problem that another thread might 
also be writing at the same time? 


race conditions and immutable data 


Marriage in Trouble. 
Can this couple be saved? y 
Next, on a very special Dr. Steve Show =] ea 


[Transcript from episode #42] - 


Welcome to the Dr. Steve show. 


We’ve got a story today that’s centered around one of the top reasons why 
couples split up—finances. 


Today’s troubled pair, Ryan and Monica, share a bank account. But not for 
long if we can’t find a solution. The problem? The classic “two people—one 
bank account” thing. 


Here’s how Monica described it to me: 


“Ryan and I agreed that neither of us will overdraw the checking account. 
So the procedure is, whoever wants to spend money must check the 
balance in the account before withdrawing cash or spending on a card. 
It all seemed so simple. But suddenly we’re getting hit with b 
overdraft fees! ee 


I thought it wasn’t possible; I thought our procedure was safe. 
But then this happened: 


Ryan had a full online shopping cart totalling $50. He checked the balance 
in the account and saw that it was $100. No problem. So he started the 
checkout procedure. 


And that’s where Icome in; while Ryan was filling in the shipping details, I Ryan and Monica: victims 
wanted to spend $100. I checked the balance, and it’s $100 (because Ryan the “two People, one 
hasn’t clicked the “Pay” button yet), so I think, no problem. So I spend account” Problem. 

the money, and again no problem. But then Ryan finally pays, and we’re 

suddenly overdrawn! He didn’t know that I was spending money at the 

same time, so he just went ahead and completed his transaction without 

checking the balance again. You’ve got to help us, Dr. Steve!” 


Is there a solution? Are they doomed? We can’t help them with their 
online shopping addiction, but can we make sure one of them can’t start 
spending while the other one is shopping? 


Take a moment and think about that while we go to a commercial break. 
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Ryan and Monica code 


The Ryan and Monica problem, in code 


The following example shows what can happen when two threads 
(Ryan and Monica) share a single object (the bank account). 


The code has two classes, BankAccount and RyanAndMonicaJob. 
There’s also a RyanAndMonicaTest with a main method to run 
everything, The RyanAndMonicaJob class implements Runnable, 
and represents the behavior that Ryan and Monica both have— 
checking the balance and spending money. 


Runnable 


BankAccount 


The RyanAndMonicaJob class has instance variables for the shared 


BankAccount, the person’s name, and the amount they want to int balance 


getBalance() 
spend() 


spend. The code works like this: 


© Make an instance of the shared bank account 
Creating a new one will set up all the defaults correctly. 
BankAccount account = new BankAccount () ; 

@ Make one instance of RyanAndMonicaJob for each 
person 


We need one job for each person. We also need to give them 
access to the BankAccount and tell them how much to spend. 


RyanAndMonicaJob 


BankAccount account 
String name 

int amountToSpend 
run() 

goShopping() 


RyanAndMonicaJob ryan = new RyanAndMonicaJob("Ryan", account, 50); 
RyanAndMonicaJob monica = new RyanAndMonicaJob("Monica", account, 100); 


© Create an ExecutorService and give it the two jobs 


Since we know we have two jobs, one for Ryan and one for Monica, we can 
create a fixed-sized thread pool with two threads. 


ExecutorService executor = Executors .newFixedThreadPool (2); 
executor .execute (ryan) ; 
executor .execute (monica) ; 


© Watch both jobs run 


One thread represents Ryan, the other represents Monica. Both threads 
check the balance before spending money. Remember that when more than 
one thread is running at a time, you can't assume that your thread is the 
only one making changes to a shared object (e.g., the BankAccount). Even 
if there's only two lines of code related to the shared object, and they're 
right next to each other. 


if (account.getBalance() >= amount) { 
account . spend (amount) ; 

} else { 
System.out.printlin("Sorry, not enough money"); 


} 
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In the goShopping() 
method, do exactly 
what Ryan and Monica 
would do—check the 
balance and, if there’s 
enough money, spend. 


This should protect 
against overdrawing 
the account. 


Except...if Ryan and 
Monica are spending 
money at the same 
time, the money in the 
bank account might be 
gone before the other 
one can spend it! 


race conditions and immutable data 


The Ryan and Monica example 


import java.util.concurrent.*; There will be o 


b KAecount: That means bo 
iN this one account: 


£ the 
instance O 
nly ONE sta th threads 


Make two jobs 


public class RyanAndMonicaTest { 


. ss tha i 
public static void main(String[] args) { will atte bis will do the 
BankAccount account = new BankAccount () ; mag" 1 drawal from 
RyanAndMonicaJob ryan = new RyanAndMonicaJob("Ryan", account, 50) he shared bank 


RyanAndMonicaJob monica = new RyanAndMonicaJob("Monica", account, 100) ;d¢Count, one foe 
ExecutorService executor = Executors.newFixedThreadPool (2) ; Monieg and £ 
executor .execute (ryan) ; Cna Start both . b an $ one tor 
executor .execute (monica) ;& running. Joos Crea 4 i yan, rag in the 
executor . shutdown () ; j a new thread mount they re going 
} + Forget to shut the pool down: Pool with two Spend. 
} Don threads for ouv t 
jobs. id 


class RyanAndMonicaJob implements Runnable { 
private final String name; 
private final BankAccount account; 
private final int amountToSpend; 
RyanAndMonicaJob (String name, BankAccount account, int amountToSpend) { 
this.name = name; 
this.account = account; 
this.amountToSpend = amountToSpend; 
} ‘ 
() method just calls goShopping? 
public void run() { ces t they need to spend: 
goShopping (amount ToSpend) ; with the amoun 


Cheek the acount balance, and if there's 
we go ahead and spend the 
yan and Moniea did. 


private void goShopping(int amount) { 
if (account.getBalance() >= amount) { Ln enough money) 
System.out.printin(name + " is about to spend"); money) just like R 
account . spend (amount) ; 
System.out.println(name + " finishes spending"); We put in a bunch f pri 
} else { dleint of Print 
System.out.printlin("Sorry, not enough for " + name); ; SO we lân see 
} what's happening as it runs. 


class BankAccount { 


r with a 
private int balance = 100; <——— The aecount, tare 
public int getBalance() { balance ov 1 

return balance; 
} 
public void spend(int amount) { 
balance = balance - amount; 
if (balance < 0) { 
System. out .printlin ("Overdrawn!") ; 


} 
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Ryan and Monica output 


How did this 
happen? 


File Edit Window Help Visa 


java RyanAndMonicaTest 


Ryan is about to spend 
Monica is about to spend 
Overdrawn! 


Ryan finishes spending 


Monica finishes spending 


This code is not deterministic: it 
doesn’t always produce the same result 
every time. You may need to run it a 
few times before you see the problem. 


This is common with multithreaded 
code, since it depends upon which 
threads start first and when each 
thread gets its time on a CPU core. 


Sometimes the 


tode wor 
t orvettly and 
they dont 9¢ 


overdrawn 
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File Edit Window Help WorksOnMyMachine 


java RyanAndMonicaTest 


Ryan is about to spend 


Ryan finishes spending 


Sorry, not enough for Monica 


The goShopping() method 
always checks the balance 
before making a withdrawal, 
but still we went overdrawn. 


Here’s one scenario: 


Ryan checks the balance, sees that 
there’s enough money, and goes to check 
out. 


Meanwhile, Monica checks the balance. 
She, too, sees that there’s enough money. 
She has no idea that Ryan is about to pay 
for something. 


Ryan completes his purchase. 


Monica completes her purchase. Big 
Problem! In between the time when 
she checked the balance and spent the 
money, Ryan had already spent money! 


Monica’s check of the account was 
not valid, because Ryan had already 
checked and was still in the middle of 
making a purchase. 


Monica must be stopped from getting into 
the account until Ryan has finished, and 
vice versa. 


race conditions and immutable data 


They need a lock for account access! 


The lock works like this: 


© There's a lock associated with the bank 


account transaction (checking the balance 
and withdrawing money). There's only 

one key, and it stays with the lock until 
somebody wants to access the account. 


When Ryan wants to access the bank 
account (to check the balance and withdraw 
money), he locks the lock and puts the key 
in his pocket. Now nobody else can access 
the account, since the key is gone. 


Ryan keeps the key in his pocket until he 
finishes the transaction. He has the only 
key, so Monica can't access the account 
until Ryan unlocks the account and returns 
the key. 


Now, even if Ryan gets distracted after 

he checks the balance, he has a guarantee 
that the balance will be the same when he 
spends the money, because he kept the key 
while he was doing something else! 


The bank account 
transaction is 
unlocked when 
nobody is using 
the account. 


When Ryan 

wants to access 
the account, he 
secures the lock 
and takes the key. 


When Ryan is 
finished, he 
unlocks the lock 
and returns the 
key. Now the key 
is available for 
Monica (or Ryan 
again) to access 
the account. 
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using synchronized 


We need to check the balance and spend 
the money as one atomic thing AY 


We need to make sure that once a thread starts a shopping transaction, it 
must be allowed to finish before any other thread changes the bank account. 


In other words, we need to make sure that once a thread has checked the 
account balance, that thread has a guarantee that it can spend the money 
before any other thread can check the account balance! 


Use the synchronized keyword on a method, or with an object, to 
lock an object so only one thread can use it at a time. 


That’s how you protect the bank account! We can put a lock on the bank 
account inside the method that does the banking transaction. That way, 
one thread gets to complete the whole transaction, start to finish, even if 
that thread is taken out of the “running” state by the thread scheduler or 
another thread is trying to make changes at exactly the same time. 


On the next couple of pages we'll look at the different things that we can 
lock. With the Ryan and Monica example, it’s quite simple—we want to 
wrap our shopping transaction in a block that locks the bank account: 


private void goShopping(int amount) { 
synchronized (account) { 
if (account.getBalance() >= amount) { 


account . spend (amount) ; 


else { 


System.out.println(name + " is about to spend"); 
System.out.printlin(name + " finishes spending"); 


System.out.printin("Sorry, not enough for " + name); 


The synchronized 
keyword means that 
a thread needs a key 
in order to access the 
synchronized code. 


To protect your data 
(like the bank account), 
synchronize the code 
that acts on that data. 


there are no 


Dumb Questions 


Q: Why don’t you just synchronize all the getters and 


(Note for You physi¢s—savvy readers: yes, the 
convention of using the word “atomie here 

does not reflect the whole subatomic particle 
thing. Think Newton, not Einstein, when you hear 
the word “atomit” in the context of threads 

or transactions. Hey, it’s not OUR Convention. 

If WE were in charge, we'd apply Heisenbera’s 
Uncertainty Principle to pretty much everything 
related to threads.) 
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setters from the class with the data you're trying to protect? 


A: Synchronizing the getters and setters isn’t enough. 
Remember, the point of synchronization is to make a specific 
section of code work ATOMICALLY. In other words, it’s not 
just the individual methods we care about; it's methods that 
require more than one step to complete! 


Think about it. We added a synchronized block inside the 
goShopping() method. If getBalance() and spend() were both 
synchronized instead, it wouldn't help—Ryan (or Monica) 
would have checked the balance returned the key! The whole 
point is to keep the key until both operations are completed. 


Using an objects lock 


Every object has a lock. Most of the time, the lock 
is unlocked, and you can imagine a virtual key 
sitting with it. Object locks come into play only 
when there is a synchronized block for an object 


(like in the last page) or a class has synchronized 
methods. A method is synchronized if it 
has the synchronized keyword in the method 
declaration. 


When an object has one or more 
synchronized methods, a thread can 
enter a synchronized method only 
if the thread can get the key to the 
object’s lock! 


The locks are not per method, they are per object. 
If an object has two synchronized methods, 

it doesn’t only mean two threads can’t enter 

the same method. It means you can’t have 

two threads entering any of the synchronized 
methods. If you have two synchronized methods on the 
same object, method1() and method2(), if one thread is in 
method 1(), a second thread can’t enter method1(), obviously, 
but it also can’t enter method2(), or any other synchronized 
method on that object. 


Think about it. If you have multiple methods that can 
potentially act on an object’s instance variables, all those 
methods need to be protected with synchronized. 


The goal of synchronization is to protect critical data. But 
remember, you don’t lock the data itself} you synchronize the 
methods that access that data. 


So what happens when a thread is cranking through its call 
stack (starting with the run() method) and it suddenly hits a 
synchronized method? The thread recognizes that it needs 
a key for that object before it can enter the method. It looks 
for the key (this is all handled by the JVM; there’s no API in 
Java for accessing object locks), and if the key is available, 
the thread grabs the key and enters the method. 


From that point forward, the thread hangs on to that key 
like the thread’s life depends on it. The thread won’t give up 
the key until it completes the synchronized method or block. 
So while that thread is holding the key, no other threads can 
enter any of that object’s synchronized methods, because the 
one key for that object won’t be available. 


Hey, this object's 
takeMoney() method is 
synchronized. I need to get 
this object's key before I 
can go in... 


race conditions and immutable data 


Every Java object has a lock. 
A lock has only one key. 


Most of the time, the lock is 
unlocked and nobody cares. 


But if an object has 
synchronized methods, a 
thread can enter one of the 
synchronized methods ONLY 
if the key for the object’s lock 
is available. In other words, 
only if another thread hasn't 
already grabbed the one key. 
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using synchronized 
Using synchronized methods 


Can we synchronize the goShopping() method to fix Ryan and Monica’s problem? 


private synchronized void goShopping(int amount) { 
if (account.getBalance() >= amount) { 
System.out.printin(name + " is about to spend"); 
account . spend (amount) ; 
System.out.println(name + " finishes spending"); 
} else { 
System.out.printin("Sorry, not enough for " + name); p:i Eeee i elohth wen Ee 


java RyanAndMonicaTest 


Ryan finishes spending 


Monica is about to spend 


It does NOT work! Overdrawn! 
2E 


Monica finishes spending 


The synchronized keyword locks an object. ‘The goShopping() method is in RyanAnd- 
MonicaJob. Synchronizing an instance method means “lock this RyanAndMonicaJob 
instance.” However, there are two instances of RyanAndMonicaJob; one is “ryan,” 
and the other is “monica.” If “ryan” is locked, “monica” can still make changes to 
the bank account; she doesn’t care that the “ryan” job is locked. 


The object that needs locking, the object these two threads are fighting over, is the 
BankAccount. Putting synchronized on a method in RyanAndMonicaJob (and lock- 
ing a RyanAndMonicaJob instance) isn’t going to solve anything. 
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race conditions and immutable data 


It’s important to lock the correct object 


Since it’s the BankAccount object that’s shared, you could argue it should be the BankAccount that’s in 
charge of making sure it is safe for multiple threads to use. The spend() method on BankAccount could 


make sure there’s enough money and debit the account in a single transaction. 


class RyanAndMonicaJob implements Runnable { 


// ...vest of the RyanAndMonicaJob class 
// the same as before... a ko heck 
naer WEE we 
private void goShopping(int amount) { This would ee spending S 
System.out.println (name + " is about to spend"); the palanta eAetount sye 
account .spend (name, amount) ; know pets Lor us: 
System.out.println(name + " finishes spending"); mekhod © 
} 
} 
class BankAccount { i the nk Ae 
nce th Count 


Ba 
// other methods in BankAccount... ce e 
He using 0 threads 


public synchronized void spend(String name, int amount) { 


if (balance >= amount) { T 
balance = balance - amount; R jð Monta ened à 
if (balance < 0) { an now) AS 

awn 
System. out .println("Overdrawn!") ; ee 9o et "the ease: 
} never e 
} else { 
System. out .printin("Sorry, not enough for " + name); 
E, ps areno 
} : he balance check and balane. um Questions 
eĉrease in th nce 
} n the BankAee . ° 
is method is Synchronized t e If Q: What about protecting static variable state? If you 
an Atomic transaction that is becomes have static methods that change the static variable state, 
in tull by only one thread at oe can you still use synchronization? 


A: Yes! Remember that static methods run against the 
class and not against an individual instance of the class. 

So you might wonder whose object's lock would be used 
ona static method? After all, there might not even be any 
instances of that class. Fortunately, just as each object has 
its own lock, each loaded class has a lock. That means if you 
have three Dog objects on your heap, you have a total of 
four Dog-related locks; three belonging to the three Dog 
instances, and one belonging to the Dog class itself. When 
you synchronize a static method, Java uses the lock of the 
class itself. So if you synchronize two static methods ina 
single class, a thread will need the class lock to enter either 
of the methods. 
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synchronization matters 


The dreaded “Lost Update” problem 


Here’s another classic concurrency problem. Sometimes you'll hear them called “race conditions,” 
where two or more threads are changing the same data at the same time. It’s closely related to the 
Ryan and Monica story, so we'll use this example to illustrate a few more points. 


The lost update revolves around one process: 
Step 1: Get the balance in the account 
int i = balance; 


ae process 
Step 2: Add 1 to that balance men 


prdbably rot è" 


balance = i + 1; 


Even if we used the more common syntax of balance++, there is no guarantee that the 
compiled bytecode will be an “atomic process.” In fact, it probably won’t—1t’s actually multiple 
operations: a read of the current value and then adding one to that value and setting it back into 
the original variable. 


In the “Lost Update” problem, we have many threads trying to increment the balance. ‘Take a look 


at the code, and then we’ll look at the real problem: Create ® thread ere 
I the jobs YO Ecce even 
threads here Yh 
a es- 
public class LostUpdate { more missing VP 


public static void main(String[] args) throws InterruptedException { 
ExecutorService pool = Executors .newFixedThreadPool (6) ; ne a 


Run 1,000 
Balance balance = new Balance (); , attem ts to 
for (int i = 0; i < 1000; i++) { É the balance, on Fi ae Nea 
pool.execute(() -> balance.increment () ) ; eads. 
} 


pool.shutdown () ; ol has Finished 


he po 
if (pool.awaitTermination(1, TimeUnit.MINUTES)) { e~ Make w dates before 
System.out .println ("balance = " + balance.balance); vunnmį a fi \ balante. iy 
} cinting the ina yhe 1,000. Ik 
) 4 is shou ? ve o 
E Sor te Ra 
an vpda | 
class Balance { H 
int balance = 0; a y the Crucial part! w, . 
. a ing © Inĉreme 
public void increment () { THE TIME whatever the (dlia e the balance 


balance++; f b 
} tc whatever the bie IT Cathey ‘San was AT 
} that “py . NT value is) a ding l to 
IS an atomic Aad You might thi 
Peration, but iti i ink 
IT IS not. 
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Let’s run this code... 


© Thread A runs for a while 
Reads balance: 0 A 


Set the value of balance to 0 + 1. ay 


Now balance is 1 


Reads balance: 1 
Set the value of balance to 1 + 1. 
Now balance is 2 


@ Thread B runs for a while 
A Reads balance: 2 


kaad Set the value of balance to 2 + 1. 


Now balance is 3 


Reads balance: 3 


[now thread B is sent back to runnable, 
before it sets the value of balance to 4] 


@) Thread A runs again, picking up where it left off 


Reads balance: 3 A 
Set the value of balance to 3 + 1. Vay 
Now balance is 4 


Reads balance: 4 
Set the value of balance to 4 + 1. 
Now balance is 5 


@ Thread B runs again, and picks up exactly where it left off! 
A Set the value of balance to 3 + 1. 


T Now balance is 4 
S~ yell 


Thread À updated it to 5, but 
now B came back and stepped 
on toP of the update A made, 
as if A's update never happened. 


race conditions and immutable data 


We lost the last updates 
that Thread A made! 
Thread B had previously 
done a “read” of the value 
of balance, and when B 
woke up, it just kept going 
as if it never missed a beat. 
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synchronizing methods 


Make the increment() method atomic. 


Synchronize it! 


Synchronizing the increment() method solves the “Lost Update” 


problem, because it keeps the steps in the method (read of balance 


and increment of balance) as one unbreakable unit. 


public synchronized void increment () { 


balance+t+; 


| ` 


i : thi ks like 
Classit conturrency gotcha: this lool 
a Geile operation, but it’s actually more 
than one—it’s a vead of the balance, an 
imtrement) and an update to the balance. 


there, are_no 


Dumb Questions 


Q: Sounds like it’s a good idea to synchronize 
everything, just to be thread-safe. 


A: Nope, it’s not a good idea. Synchronization doesn't 
come for free. First, a synchronized method has a certain 
amount of overhead. In other words, when code hits a 
synchronized method, there's going to be a performance hit 
(although typically, you'd never notice it) while the matter of 
“is the key available?” is resolved. 


Second, a synchronized method can slow your program 
down because synchronization restricts concurrency. In 
other words, a synchronized method forces other threads to 
get in line and wait their turn. This might not be a problem 
in your code, but you have to consider it. 


Third, and most frightening, synchronized methods can lead 
to deadlock! (We'll see this in a couple of pages.) 


A good rule of thumb is to synchronize only the bare 
minimum that should be synchronized. And in fact, you 

can synchronize at a granularity that’s even smaller than a 
method. Remember, you can use the synchronized keyword 
to synchronize at the more fine-grained level of one or more 
statements, rather than at the whole-method level (we used 
this in our first solution to Ryan and Monica's problem). 
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Once a thread enters 
the method, we have 

to make sure that all 
the steps in the method 
complete (as one 
atomic process) before 
any other thread can 
enter the method. 


doStuff() doesn't need to, 
be synchronized, so we don't 
synchronize the whole method. 


public void go() { 
doStuff (); 


synchronized (this) { 


criticalStuff (); 


moreCriticalStuff () ; 


Although there are other ways to 


will almost alwa ; 
objeet (this). sa i 


lock if the whole metho, 


do it, You 
he current 
e Sdme object you'd 

d were synchronize d. 


Now, only these 4 
into one atomit hers prea th are 
ae imal WITHIN aia 
n in a method declarati , 
f Pa Provide an argument iid a 
eee whose key the thread needs to i 


race conditions and immutable data 


© Thread A runs for a while 


Attempt to enter the increment() method. 


The method is synchronized, so get the key for this object 


Reads balance: 0 

Set the value of balance to 0 + 1. 

Now balance is 1 

Return the key (it completed the increment() method). 
Re-enter the increment() method and get the key. 
Reads balance: 1 


[now thread A is sent back to runnable, but since it has not 
completed the synchronized method, Thread A keeps the key] 


© Thread B is selected to run 
A 


Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 


The key is not available. 


@) Thread A runs again, picking up where it left off 
(remember, it still has the key) 


Set the value of balance 1 + 1. 
Now balance is 2 


Return the key. 


[now thread A is sent back to runnable, but since it 
has completed the increment() method, the thread 
does NOT hold on to the key] 


@ Thread B is selected to run 


3 Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 


This time, the key IS available; get the key. 
Reads balance: 2 


[continues to run...] 


[now thread B is sent into an “object lock not available” lounge] 
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thread deadlock 


Deadlock, a deadly side of synchronization 


Synchronization saved Ryan and Monica from using their bank account at the 
same time, and has saved us from losing updates. But we also mentioned that we 


shouldn’t synchronize everything, one reason being that synchronization can slow 
> 


your program down. 


There’s another important consideration: we need to be careful using 
synchronized code, because nothing will bring your program to its knees like 
thread deadlock. Thread deadlock happens when you have two threads, both 
of which are holding a key the other thread wants. There’s no way out of this 
scenario, so the two threads will simply sit and wait. And wait. And wait. 


If yow’re familiar with databases or other application servers, you might 
recognize the problem; databases often have a locking mechanism somewhat like 
synchronization. But a real transaction management system can sometimes deal 
with deadlock. It might assume, for example, that deadlock might have occurred 
when two transactions are taking too long to complete. But unlike Java, the 
application server can do a “transaction rollback” that returns the state of the 
rolled-back transaction to where it was before the transaction (the atomic part) 
began. 


Java has no mechanism to handle deadlock. It won’t even know deadlock occurred. 


So it’s up to you to design carefully. We’re not going to go into more detail about 
deadlock than you see on this page, so if you find yourself writing multithreaded 
code, you might want to study Java Concurrency in Practice by Brian Goetz, et al. It 


All it takes for 
deadlock are two 
objects and two 
threads. 


goes into a lot of detail about the sorts of problems you can face with concurrency 


(like deadlock), and approaches to address these problems. 


A simple deadlock scenario: 


© 9 


3 synchronized method E 
of object foo and gets 
the key. f 


Thread B enters a 
synchronized method 
of object bar and gets 


the key. 7 


Thread B tries to enter 
a synchronized method 
of object foo, but can’t 
get that key (because 

=A has it). B goes to 
the waiting lounge, until 
the foo key is available. 
B keeps the bar key. 


Thread A enters a 


E 
* 


Thread A goes to 
O sleep, holding the 
foo key. 


Wie 
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Thread A wakes up (still 

4 a holding the foo key) 
and tries to enter a 
synchronized method on 

* object bar but can’t get 
that key because B has 
it. A goes to the waiting 
lounge until the bar key is 
available (it never will be!). 


© 
2 


Thread A can’t run until 

“it can get the bar key, 
but B is holding the bar 
key and B can’t run until it 
gets the foo key that Ais 
holding and... 


race conditions and immutable data 


You don't always have to use synchronized 


Since synchronization can come with some costs (like performance and potential deadlocks), you 
should know about other ways to manage data that’s shared between threads. The java.util.concurrent 
package has lots of classes and utilities for working with multithreaded code. 


Atomic variables 


If the shared data is an int, long, or boolean, we might be able to replace it with an atomic 
variable. These classes provide methods that are atomic, i.e., can safely be used by a thread 
without worrying about another thread changing the object’s values at the same time. 


There are few types of atomic variable, e.g, AtomicInteger, AtomicLong, 
AtomicBoolean, and AtomicReference. 


We can fix our Lost Update problem with an AtomicInteger, instead of synchronizing the 
increment method. 


alized to 
class Balance { Drtomielnteger ee 
AtomicInteger balance = new AtomicInteger (0) ; Use an ead of an int valve 
a zero) W 
public void increment() { iney 
ue balance. increment AndGet () ; Rs Pris tndóet a atomical 
} TS used b adds on 
} ved? KL. ac FS value by o pa l ig ir ‘le A i ae he Nahe, i ie, even 
thronize Singje 
No need d to add ` pe ie operations need thot f returns the Aa peralin The herenera i 
ov ve using 3 re or our le » updated val, n ndGet 
when Y urned value. Ple; é : t we don’t 


So I canuse 
AtomicInteger as long 

as all I want to do is a simple 

increment. How does this help 

me if I want to do normal things 

like complex calculations? 


Atomic variables get more interesting when you use their compare-and-swap (CAS) 
operations. CAS is yet another way to make an atomic change to a value. You 
can use CAS on atomic variables by using the compareAndSet method. Yes, 
it’s a slightly different name! Gotta love programming, where naming is always 


the hardest problem to solve. 


The compareAndSet method takes a value, which is what you expect the atomic 
variable to be, compares it to the current value, and if that matches, then the 
operation will complete. 


In fact, we can use this to fix our Ryan and Monica problem, instead of locking 
the whole bank account with synchronized. 
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atomic variables 


Compare-and-swap with atomic variables 


How could we make use of atomic variables, and CAS (via compareAndSet), to solve Ryan and 
Monica’s problem? 


Since Ryan and Monica were both trying to access an int value, the account balance, we could use an 
AtomiclInteger to store that balance. We could then use compareAndSet to update the balance when 
someone wants to spend money. 


private AtomicInteger balance = new AtomicInteger (100) ; 


boolean success = balance.compareAndSet (expectedValue, newValue) 


F th 

dated to | e Curr, 

Tove i£ n val poe alse, the Sdme as ie a is the 

the new va af changed and update it 4, the nea he 

posed yon you need to do next: alue. 
etae W 

In plain English: 


“Set the balance to this new value only if the current balance is 
the same as this expected value, and tell me if the balance was 
actually changed.” 


Compare-and-swap uses optimistic locking. Optimistic locking means you don’t stop all 
threads from getting to the object; you łry to make the change, but you embrace the fact 
that the change might not happen. If it doesn’t succeed, you decide what to do. You 


might decide to try again, or to send a message letting the 
user know it didn’t work. 


This may be more work than simply locking all other When you're using CAS 
operations, you have to deal 


threads out from the object, but it can be faster than locking 
everything, For example, when the chances of multiple writes 


with the times when the 


of threads reading and not so many writing, then you may operation does NOT succeed. 


not want to pay the price of a lock on every write. 


happening at the same time are very low or if you have a lot 
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race conditions and immutable data 


Ryan and Monica, going atomic 


Let’s see the whole thing in action in Ryan and Monica’s bank account. We’ll put the balance in an AtomicInteger and 
use compareAndSet to make an atomic change to the balance. 


import java.util.concurrent .atomic.AtomicInteger; Stor: 
e the balance in an Atomi 
y mielnt, 


the same initial value ($100) as al i 


class BankAccount { 
private final AtomicInteger balance = new AtomicInteger (100) ; 

public int getBalance() { 
return balance.get (); 


to get the int 
the get() method to 9e 
kk aioe Vse of The Abomelnteger 


public void spend(String name, int amount) { 


; ) h money. This 
int initialBalance = balance.get (); Like before, check if neve oe money 
if (initialBalance >= amount) { Lime, keep a record or the balante: 


boolean success = balance.compareAndSet (initialBalance, initialBalance - amount); 


7 ait Pass in Lh D ii 

te will NOT be change e balance f is is the “spend, 
He er balance does not matth a we Checked if ee icone he amount spent 
Lhe actual balance right now: nough money. From the 3ecount balante. 


if (!success) { 


System.out.printlin("Sorry " + name + ", you haven't spent the money."); 


} 
uc 
} else { mone fess was false 
System.out.println("Sorry, not enough for " + name); Tell Y was NOT sp mi 
: An ent. 
didn’4 or Moni 
CQ i 
} decid, “rk and yo Ë 
ĉide th 
What to go Y Can 


java RyanAndMonicaTest 


Ryan is about to spend 
Monica is about to spend 


Ryan finishes spending java.util concurrent has 
SA oat, you eae buy this lots of useful classes and 
Monica finishes spending eleo 7 P 
utilities for working with 
multithreaded code. Take 
a look at what's there! 
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immutable objects 


So if all these problems 
are caused by writing to a shared object, what 
if we stopped threads from changing the data in the 
shared objects? Is there a way to do that? 


Make an object immutable if you’re going to 
share it between threads and you don’t want the 
threads to change its data. 

The very best way to know for sure that another thread isn’t 
changing your data is to make it impossible to change the data in 
the object. When an object’s data cannot be changed, we call it an 
immutable object. 


wang 
ube to 
might oo Ses th 
public final class ImmutableData { Values mu ra 
a private final String name; ‘mmutaby, make the 
4 private final int value; © Class Final 
hal. 
public ImmutableData(String name, int value) { 
=z — \d be this.name = name; „Ads eee á 
w Al fields show \ this.value = value; N Kiel kya 
FINAL Tree 0 ip ve “aly T 
will be set On ne ont vere i 
the field denarar public String getName () { return name; } be to 
tonstruto 
raerae be change public int getValue() { return value; } 
afterwar i } 
fomuta le ob 
o set el m 
Should f i The valu ay ha gett 
t be ch eS insid, th ers, b t 
d e o bject 
ethod. 


There are times when adding the final keyword isn't 
enough to prevent changes. When do you think that 
might be the case? We'll give you a clue... 
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race conditions and immutable data 


Using immutable objects 


It is terribly convenient to be able to change data on a shared object and as- 
sume that all the other threads will be able to see these changes. 


However, we’ve also seen that while it’s convenient, it’s not very safe. 


On the other hand, when a thread is working with an object that cannot be 
changed, it can make assumptions about the data in that object; e.g., once the 
thread has read a value from the object, it knows that data can’t change. 


We don’t need to use synchronization or other mechanisms to control who 
changes the data because it can’t change. 


Well, duh. If the data can't be 
changed, then of course I know no one 
else has altered it. But what's the use of 
an object that can't be changed? What if 
I need to update its values? 


Working with immutable objects means thinking 
in a different way. 


Instead of making changes to the same object, we replace the old 
object with a new one. The new object has the updated values, and 
any threads that need the new values need to use the new object. 


What happens to the old object? Well, if it’s still being used by 
something (and it might be—1t’s perfectly valid sometimes to work 
with older data), it will hang around on the heap. If it’s not being 
used, it’ll be garbage collected, and we don’t have to worry about it 
anymore. 
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changing immutable objects 


Changing immutable data 


Imagine a system that has customers, and that each Customer 
object has an Address that represents the street address of a 
customer. If the customer’s Address is an immutable object (all 
its fields are final and the data cannot be changed), how do you 
change the customer’s address when they move? 


1) The Customer has a reference to the original Address 
object containing the customer's street address data. 


Address 


Somer aby 


(2) When the customer moves, a brand new Address 
object is created with the new street address for the 
customer. 


42 Electric 
Avenue 


(3) The Customer object's reference to their address is 
changed to point to the new Address object. 


thereare no 


Dumb Questions 


Q: What happens if other parts of the program have a 
reference to the old Address? 


A: Actually sometimes we want this. Imagine the 
customer placed an order to be delivered to their original 
address. We still want the details of that order to have the 
original address; we don't want it changed to contain the 
details of the new address. 


Once the customer changes their address (and the Customer 
contains a reference to the new address object), then we want 
new orders to use the new Address object. 
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race conditions and immutable data 


Wait just a minute! The Address 
object is immutable and doesn't 
change, but the Customer object 
still has to change. 


Absolutely right. If your system has data that changes, those 
changes do have to happen somewhere. The key idea to take away 
from this discussion is that not all of the classes in your application 
have to have data that changes. In fact, we’d argue for minimizing 
the places where things change. Then, there are far fewer places 
where you have to think about what happens if multiple threads 
are making changes at the same time. 


There are a number of techniques for working effectively with 
immutable data classes; we’ve just scratched the surface here. It 
is interesting to note that Java 16 introduced records, which are 
immutable data classes provided directly by the language. 


Use immutable data classes where you can. 


Limit the number of places where data can be 
changed by multiple threads. 


youarehere> 661 


shared data 


Are we there yet? This 
concurrency stuff has 
been going on forever. 


More problems with shared data 


We're nearly there, we promise! Just one last thing to look at. 


So far we’ve seen all sorts of problems that can come from 
many threads writing to the same data. This applies to data in 
Collections too. 


We can even have problems when we have lots of threads reading 
the same data, even if only one thread is making changes to it. 


This code has just one thread writing to a collection, but two 
threads reading it. 


public class ConcurrentReaders { 
public static void main(String[] args) { 

List<Chat> chatHistory = new ArrayList<>() ; 

ExecutorService executor = Executors.newFixedThreadPool (3) ; 

for (int i = 0; i < 5; itt) { 
executor.execute(() -> chatHistory.add(new Chat ("Hi there!") )) Ste 
executor.execute(() -> System. out println(chatHistory) ); Create a wi ting thread 
executor.execute(() -> System.out.println(chatHistory) ) ; that adds to the List, and 


: two threads that read 
executor. shutdown () ; eg a ots 
| times to try to provoke 
i the problem. 


final class Chat { 
private final String message; Making an Obi l 
private final LocalDateTime timestamp; the dat, insi ya field “Fin ” 
a 


public Chat (String message) { 
this.message = message; 
timestamp = LocalDateTime.now (); 


Instantes of Chat are immutable. 


public String toString() { 
String time = timestamp. format (ofLocalizedTime (MEDIUM) ) ; 
return time + " " + message; 
} 
} 
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race conditions and immutable data 


Reading from a changing data 
structure causes an Exception 


Running the code on the last page causes an Exception to be thrown, 
sometimes. By now you know these sorts of issues depend a lot on 
the whims of the hardware, the operating system, and the JVM. 


File Edit Window Help PoorBrunonono 


g 


% java ConcurrentReaders 


[] 
[] 
[18:43:59 Hi there!, 18:43:59 Hi there!] 
[18:43:59 Hi there!, 18:43:59 Hi there!] 
[18:43:59 Hi there!, 18:43:59 Hi there!, 18:43:59 Hi there!] 
[18:43:59 Hi there!, 18:43:59 Hi there!, 18:43:59 Hi there!] 
Exception in thread "pool-1-thread-2" Exception in thread "pool-1-thread-1" java.util. 
ConcurrentModificationException 
at java.base/java.util.ArrayList$Itr.checkForComodification(ArrayList.java:1043) 


at java.base/java.util.ArrayList$Itr.next (ArrayList.java:997) 


at java.base/java.util.AbstractCollection.toString(AbstractCollection.java:472) 


at java.base/java.lang.String.valueOf (String. java:2951) 
at java.base/java.io.PrintStream.printin(PrintStream. java: 897) 


ConcurrentReaders.lambda$main$2 (ConcurrentReaders. java:17) 


. ion is thrown by 
ification brtepton reading 1s 


se vea WILE this thread is reading it- 


If a collection is changed by one thread while 
another thread is reading that collection, you 
can get a ConcurrentModificationException. 
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concurrent data structures 


Use a thread-safe data structure 


Clearly good ol ArrayList just isn’t going to cut it if you have threads reading data that’s 
being changed at the same time. Luckily for us, there are other options. We want a 
thread-safe data structure, one that can be written to, and read from, by multiple threads 
at the same time. 


The java.util.concurrent package has a number of thread-safe data structures, and we’re 
going to look at CopyOnWriteArrayList to solve this specific problem. 


CopyOnWriteArray List is a reasonable choice when you have a List that is being read a Ane 
lot, but not changed very often. We’ll see why later. Lise imleme" e 


public static void main(String[] args) 
List<Chat> chatHistory = new CopyOnWriteArrayList<> () ; 
ExecutorService executor = Executors.newFixedThreadPool (3) ; 
for (int i = 0; i < 5; itt) { 
executor.execute(() -> chatHistory.add(new Chat ("Hi there!"))); 
executor.execute(() -> System.out.println(chatHistory) ); 
executor.execute(() -> System.out.printlin(chatHistory) ); 


so 
erate A kor ary 
public class ConcurrentReaders { cepacern® 
{ 


} 
executor. shutdown () ; The rest of 


} Sdme as before. Code is exactly the 


File Edit Window Help AyMariposa 


java ConcurrentReaders 


[] 
[] 
[] 
[] 
[10: : Hi there!, 10: 5 Hi there!] 


[10:26:22 Hi there!, 10:26: Hi there!, : there!, 10:26:22 Hi there!] 

[10:26:22 Hi there!, 10:26: Hi there!, : there!] 

[10:26:22 Hi there!, 10:26: Hi there!, : there!, 10:26:22 Hi there!] 

[10:26:22 Hi there!, 10:26: Hi there!, : there!, 10:26:22 Hi there!, 10:26:22 Hi there! 
[10:26:22 Hi there!, 10:26: Hi there!, : there!, 10:26:22 Hi there!, 10:26:22 Hi there! 


Process finished with exit code 0 


No Exception! 
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CopyOnWriteArrayList 


CopyOnWriteArray List uses immutability to provide safe access for reading threads while other threads are writing. 


How does it work? Well, it does what it says on the tin: when a thread is writing to the list, it’s actually writing to a copy of 


the list. When the changes have been made, then the new copy replaces the original. In the meantime, any threads that 


were reading the list before the change are happily (and safely!) reading the original. 


(2) 


An instance of CopyOnWriteArrayList contains an 
ordered set of data, like an array. 935 |34 
CopyOnWriteArrayList 
When Thread A reads the CopyOnWriteArrayList, A 
it gets an Iterator that allows it to read a snapshot —> iteratine = 
of the list data at that point in time. aie Pelee 
for reading 
“pyOnWriteArrayLick 
Thread B writes data to the CopyOnWrite- A , , A 
ArrayList by adding a new element, and the 3 ? iteratine ye 
CopyOnWriteArray creates a copy of the Ir scree 
list data before any changes are made. This for reading 
is invisible to any of the reading or writing amp t 
threads. CIA E 
writing B5 |34 A 
Ss 
CopyOnypine™ 
When Thread B makes changes to “the list," A A 
it's actually making changes to this copy. It's 4 —> iterating ye 
happy knowing the changes are being made. ps |r 
The reading threads like Thread A are not referente > E 
affected at all; they're iterating over the a | for reading 
hot of the original data. al | \ 
snapshot of the original data Witing t |gs at \a\5 | 
Copy = 
Copo" 
Once Thread B has finished its updates, then the iterating A 
original data is replaced with the new data. f E 
If Thread A is still reading, it's safely reading the a 


old data. If any other threads start reading after 


the change, they get the new data. aa zares | z 
referente |gs A ie | 


; K 
or reading a 


€ 


Copo 
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concurrency issues 


there; are_no 


Dumb Questions 


- Doesn't using 
CopyOnWriteArrayList mean that 
some reading threads will be reading 
old data? 


A: Yes, the reading threads will 
always be working off data that is 

a snapshot of the data from when 
they first started reading. This means 
that potentially the data might 

be out of date at some point, but 

at least it’s not going to throwa 
ConcurrentModificationException. 


Q: Isn't it bad to be using out of 
date data? 


A: Not necessarily. In many 
systems this is “good enough.’ Think, 
for example, about a website that 
shows live news. Yes, you want it to 
be pretty up to date, but it doesn't 
have to be up to date to the latest 
millisecond; it’s probably fine if some 
news is a few seconds old. 


* But I don’t want my bank 
statement to be even slightly out 
of date! How can I make sure that 
critical shared data is always correct? 


A: CopyOnWriteArrayList is 
probably not the right choice if all 
threads need to be working off exactly 
the same data. Other data structures, 
like Vector, provide thread-safety by 
using locks to ensure only one thread 
at a time has access to the data. 

This is safe, but can be slow—you're 
not getting any benefits of multi- 
threading if your threads need to wait 
their turn to get to their data. 
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Q: So CopyOnWriteArrayList is a fast 
thread-safe data structure? 


A: Well.. it depends! It’s fast (compared 
to a locking Collection) if you have lots of 
reading threads and not many writes. But 
if there’s a lot of writing going on, it might 
not be the best data structure. The cost of 
creating a new copy of the data every time 
a single write is made might be too high 
for some applications. 


Q: Why isn’t there an easy answer 
to the best way to do this concurrency 
stuff? 


A: Concurrent programming is 

all about trade-offs. You need a good 
understanding of what your application is 
doing, how it should work, and the hardware 
and environment that’s running it. 


If you find yourself wondering which 
approach is better for your application, 
it’s probably a good time to learn about 
performance testing so you can measure 
exactly how each approach impacts the 
performance in your system. 


Q: You never told us about the case 
where adding final to a field declaration 
is not enough to make sure that value is 
never changed. What's the deal? 


A: Good catch! The “deal” is that if your 
field is a reference to another object, like 

a Collection or one of your own objects, 
using final does not prevent another 
thread from changing the values inside 
that object. The only way to make sure 
that doesn’t happen is to make sure all 
your fields that are references refer only to 
immutable objects themselves. Otherwise, 
your immutable object can have data that 
changes. 


See the LocalDateTime case on page 662. 


Thread-safe 
collections in early 
versions of Java 
were made safe via 
locking. For example, 
java.util. Vector. 


Java 5 introduced 
concurrent data 
structures in 
java.util.concurrent. 
These do NOT use 
locking. 


race conditions and immutable data 


BULLET POINTS 


You can have serious problems with threads if two or more threads are trying to 
change the same data. 


Two or more threads accessing the same object can lead to data corruption 
if one thread, for example, leaves the running state while still in the middle of 
manipulating an object's critical state. 


To make your objects thread-safe, decide which statements should be treated as 
one atomic process. In other words, decide which methods must run to completion 
before another thread enters the same method on the same object. 


Use the keyword synchronized to modify a method declaration when you 
want to prevent two threads from entering that method. 


Every object has a single lock, with a single key for that lock. Most of the time 
we don’t care about that lock; locks come into play only when an object has 
synchronized methods or use the synchronized keyword with a specified object. 


When a thread attempts to enter a synchronized method, the thread must get the 
key for the object (the object whose method the thread is trying to run). If the key 
is not available (because another thread already has it), the thread goes into a 
kind of waiting lounge until the key becomes available. 


Even if an object has more than one synchronized method, there is still only one 
key. Once any thread has entered a synchronized method on that object, no 
thread can enter any other synchronized method on the same object. This restric- 
tion lets you protect your data by synchronizing any method that manipulates the 
data. 


The synchronized keyword isn’t the only way to safeguard your data from multi- 
threaded changes. Atomic variables, with CAS operations, may be suitable if it’s 
just one value that is being changed by multiple threads. 


It’s writing data from multiple threads that causes the most problems, not reading, 
so consider if your data needs to be changed at all or if it can be immutable. 


Make a class immutable by making the class final, making all the fields final, 
setting the values just once in the constructor or field declaration, and having no 
setters or other methods that can change the data. 


Having immutable objects in your application doesn’t mean nothing ever changes; 
it means that you limit the parts of your application where you have to worry about 
multiple threads changing the data. 


There are thread-safe data structures that let you have multiple threads reading 
the data while one (or more) threads change the data. Some of these are in 
java.util.concurrent. 


Concurrent programming is difficult! But there are plenty of tools to help you. 


you are here > 
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exercise: BE the JVM 


x 
ercise BE the JVM 
The Java file on this page represents a 

. complete source file. Your job is to play 
-< JVM and determine what the output would 
be when the program runs. 


How might you fix it, making 
sure the output is correct 
every time? 


> Answers on page 670. 


import java.util.*; 
import java.util.concurrent.*; 


public class TwoThreadsWriting { 

public static void main(String[] args) { 
ExecutorService threadPool = Executors.newFixedThreadPool (2) ; 
Data data = new Data(); 
threadPool.execute(() -> addLetterToData('a', data)); 
threadPool.execute(() -> addLetterToData('A', data)); 
threadPool . shutdown () ; 

} 


private static void addLetterToData(char letter, Data data) { 

for (int i = 0; i < 26; i++) { 

data.addLetter (letter++) ; 

try { 

Thread.sleep (50) ; 

} catch (InterruptedException ignored) {} 
} 
System. out .printin (Thread. currentThread().getName() + data.getLetters () ) ; 
System. out .printin (Thread. currentThread () . getName () 

+ " size = " + data.getLetters().size()); 


} 


final class Data { 
private final List<String> letters = new ArrayList<>(); 


public List<String> getLetters() {return letters; } 
public void addLetter(char letter) { 


letters .add(String.valueOf (letter) ) ; 
} 
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O-? Near-miss at the airlock 


Q . As Sarah joined the onboard development team’s design review meeting, she gazed out the 
portal at sunrise over the Indian Ocean. Even though the ship’s conference room was incredibly 
claustrophobic, the sight of the growing blue and white crescent overtaking night on the planet 
below filled Sarah with awe and appreciation. 


Q Q. 
Five-Minute This morning’s meeting was focused on the control systems for the orbiter’s airlocks. As 
Mystery the final construction phases were nearing their end, the number of spacewalks was scheduled 
to increase dramatically, and traffic was high both in and out of the ship’s airlocks. “Good 
morning, Sarah,” said Tom, “Your timing is perfect; we’re just starting the detailed 
design review.” 


“As you all know,” said Tom, “Each airlock is outfitted with space-hardened GUI 
terminals, both inside and out. Whenever spacewalkers are entering or exiting the orbiter they 
will use these terminals to initiate the airlock sequences.” Sarah nodded and asked, “Tom, can you 
tell us what the method sequences are for entry and exit?” Tom rose and floated to the whiteboard, 
“First, here’s the exit sequence method’s pseudocode.” Tom quickly wrote on the board. 


orbiterAirlockExitSequence () 
verifyPortalStatus (); 
pressurizeAirlock (); 
openInnerHatch (); 
confirmAirlockOccupied (); 
closeInnerHatch (); 
decompressAirlock (); 
openOuterHatch () ; 
confirmAirlockVacated(); 


closeOuterHatch (); 


“To ensure that the sequence is not interrupted, we have synchronized all of the methods 
called by the orbiterAirlockExitSequence() method,” Tom explained. ““We’d hate to see a 
returning spacewalker inadvertently catch a buddy with his space pants down!” 


Everyone chuckled as Tom erased the whiteboard, but something didn’t feel right to Sarah, 
and it finally clicked as Tom began to write the entry sequence pseudocode on the whiteboard. 
“Wait a minute, Tom!” cried Sarah, “I think we’ve got a big flaw in the exit sequence design. 
Let’s go back and revisit it; it could be critical!” 


Why did Sarah stop the meeting? What did she suspect? 


— Answers on page 671. 
P g youarehere» 669 


exercise solutions 


BE the JVM (from page 668) 


The answer is the output won’t be the same every time. In theory, one 
might expect the size to always be 52 (2 X 26 letters in the alphabet), but in 
fact this is one of those lost-update problems. 


Exercise Solutions 


File Edit Window Help ZeCount 
% java TwoThreadsWriting 


pool-1-thread-2[a, A, b, B, c, pl eba ap bse hap 


pool-1-thread-l[a, A, b, B, c, ntl eba aly bi has 
pool-1-thread-1 size = 40 
pool-1-thread-2 size = 40 


le output. Your output probably won't look 
ear tg ee as this, but if you predicted that 
the size would be less than 92, you win a Cookie. 


It can be solved in two different ways; both are valid. 


Synchronize the write method 


public synchronized void addLetter(char letter) { 
letters .add(String.valueOf (letter) ) ; 


If this method is synchronized, only one thread at a time 


ill be lost. 
ite to the data, and therefore no updates will be | 
Ths will not work if there's a DIFFERENT thread reading 
at the same time as one of these threads ave writing. 


Use a thread-safe collection 
private final List<String> letters = new CopyOnWriteArrayList<>() ; 


Using C , ; 
9 opyOnWriteArra List wil 
ii safely write to i aae eead: 


Use either solution, you do NOT have to do both!! 


With a thread-safe collection, you don’t have to 
synchronize the writing method. 
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Five-Minute Mystery 


(from page 669) 


What did Sarah know? 


Sarah realized that in order to ensure that the entire 
exit sequence would run without interruption the 
orbiterAirlockExitSequence() method needed to 
be synchronized. As the design stood, it would be possible 
for a returning spacewalker to interrupt the Exit Sequence! 
The Exit Sequence thread couldn’t be interrupted in the 
middle of any of the lower-level method calls, but it could 
be interrupted in between those calls. Sarah knew that the 
entire sequence should be run as one atomic unit, and if 
the orbiterAirlockExitSequence() method was 
synchronized, it could not be interrupted at any point. 
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* X 
Appendix A: 


a a 
Final Code Kitchen * ant, to the 
Your message oe ° with your 
ers, a ond 
er Play hen YOu 
ot nt beat patter when Y 
ture i 
hit “send 
eee Cyber BeatBox 
Bass Drum Start 
Closed Hi-Hat € Stop 
Open Hi-Hat [ 
Tempo Up 
Acoustic Snare rE a 
Crash Cymbal _Tempo Down — 
Hand Clap i s € F 5 sendit 
High Tom Try this| 
Hi Bongo 
Maracas 5 
ae 
Isue : j E : 7 z i ~- |RiverO: Dance beat 
Low Conga EstuaryEcho0: Groove #2 revised 
Cowbell - ~ |River1: Energy build up 
Vibraslap 
Low-mid Tom Ses ese i a ry 
High Agogo 
Open Hi Conga 


9 messages f 
Finally, the complete version of the BeatBox! aia Click one ree d 
n Pattern tha ge: 
It connects to a simple MusicServer so that you can i ia 1 and then cliep 
send and receive beat patterns with other clients. © to play it 
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final BeatBox code 


Final BeatBox client program 


Most of this code is the same as the code from the Code Kitchens in the previous chapters, so we don’t 
annotate the whole thing again. The new parts include: 


GUI: Two new components are added for the text area that displays incoming messages (actually a 
scrolling list) and the text field. 


NETWORKING: Just like the SimpleChatClient in this chapter, the BeatBox now connects to the 
server and gets an input and output stream. 


MULTITHREADED: Again, just like the SimpleChatClient, we start a “reader” job that keeps looking 
for incoming messages from the server. But instead of just text, the messages coming in include TWO 
objects: the String message and the serialized array (the thing that holds the state of all the checkboxes). 


All the code is available at https://oreil. ly /hffava_3e_examples. 


import javax.sound.midi.*; 
import javax.swing.*; 

import javax.swing.event.*; 
import java.awt.*; 

import java.io.*; 

import java.net .Socket; 

import java.util.*; 

import java.util.concurrent.*; 


import static javax.sound.midi.ShortMessage.*; 
public class BeatBoxFinal { 

private JList<String> incomingList; 

private JTextArea userMessage; 


private ArrayList<JCheckBox> checkboxList; 


private Vector<String> listVector = new Vector<>() ; 
private HashMap<String, boolean[]> otherSeqsMap = new HashMap<>() ; 


private String userName; 
private int nextNum; 


private ObjectOutputStream out; 


private ObjectInputStream in; he 
the names ok © These represent the 
A 4 
private Sequencer sequencer; These are as 2 aa actual drum na The 
? . . 
private Sequence sequence; anstorume” ‘puilding) © e drum channel is like 
private Track track; arra) (on eath cow): “ Piano, except each 
\abels *° A on the piano is a 
String[] instrumentNames = {"Bass Drum", "Closed Hi-Hat", di ferent drum. So the 
"Open Hi-Hat", "Acoustic Snare", "Crash Cymbal", "Hand Clap", number ‘35’ is the ke 
"High Tom", "Hi Bongo", "Maracas", "Whistle", "Low Conga", TO the Bass drum, 42. 
"Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", is Closed Hi-Hat, ete. 


"Open Hi Conga"}; 
int[] instruments = {35, 42, 46, 38, 49, 39, 50, 60, 70, 72, 64, 56, 58, 47, 67, 63}; 
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public static void main(String[] args) { ame. 
new BeatBoxFinal () .startUp (args[0]); Add a tommand-line argument for your screen nam 
Example: % jeva BeatBoxFinal theFlash 
public void startUp(String name) { 
userName = name; b orkina, \/0, and make 
i / v connection to the server ard a) tne reader ae a 
= i here instead or Chann 
Socket socket = new Socket ("127.0.0.1", 4242); rei pares work better with Object 


out = new ObjectOutputStream (socket .getOutputStream() ) ; + streams. 
in = new ObjectInputStream (socket .getInputStream() ) ; Input/Outpu al 
ExecutorService executor = Executors.newSingleThreadExecutor () ; 
executor.submit (new RemoteReader () ) ; 

} catch (Exception ex) { 
System.out.printlin("Couldn’t connect-you’11 have to play alone."); 

} 

setUpMidi () ; 

buildGUI () ; 


You've seen this Gul code 


public void buildGUI() { ' ter |5. 
JFrame frame = new JFrame("Cyber BeatBox") ; before, m Chap 


frame .setDefaultCloseOperation (JFrame .EXIT_ON_CLOSE) ; 

BorderLayout layout = new BorderLayout () ; 

JPanel background = new JPanel (layout) ; 

background. setBorder (BorderFactory.createEmptyBorder(10, 10, 10, 10)); 


Box buttonBox = new Box (BoxLayout .Y_AXTS) ; etween the 
JButton start = new JButton ("Start"); where th 
start .addActionListener(e -> buildTrackAndStart () ) ; 
buttonBox.add (start); 


JButton stop = new JButton ("Stop"); i 
stop.addActionListener (e -> sequencer.stop()); Lambda expression 
buttonBox.add (stop) ; on this class when 


s call a specifie method 
the button is pressed. 


JButton upTempo = new JButton("Tempo Up"); 
upTempo.addActionListener(e -> changeTempo(1.03£) ); ‘oe ele 
buttonBox.add (upTempo) ; is LOs 
yea RO The default be i, er diek. 
JButton downTempo = new JButton ("Tempo Down"); K adjusting t= 
downTempo .addActionListener (e -> changeTempo (0.97£)); 
buttonBox .add (downTempo) ; 


JButton sendIt = new JButton("sendIt") ; This is new; send the wana i 
sendIt .addActionListener(e -> sendMessageAndTracks () ) ; the current beat sequence 
buttonBox.add(sendIt) ; musil server: 

userMessage = new JTextArea () ; h 
userMessage.setLineWrap (true) ; Create a text area for the 
userMessage.setWrapStyleWord (true) ; user to type their message- 


JScrollPane messageScroller = new JScrollPane (userMessage) ; 
buttonBox.add(messageScroller) ; 
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We saw JList briefly in 
messages are displayed. 
you ju 
message 


from the list to 


incomingList new JList<>(); 
incomingList .addListSelectionListener (new MyListSelectio 


incomingList .setSelectionMode (ListSelectionModel . SINGLE_, 


JScrollPane theList new JScrollPane (incomingList) ; 
buttonBox.add(theList) ; 
incomingList .setListData (listVector) ; 


Box nameBox new Box (BoxLayout . Y_AXIS) ; 
for (String instrumentName instrumentNames) { 
JLabel instrumentLabel new JLabel (instrumentName) ; 


Chapter 
Only inste 
st LOOK at the messages, 


This border o! 
helps them lin 


I5. This is where e pesi 
d of a normal chat where 
5 n this app you Can SELECT a 


load and play the attached beat pattern- 


nListener ()); 
SELECTION) ; 


n eath instrument name 
e up with the checkboxes. 


instrumentLabel .setBorder (BorderFactory.createEmptyBorder (4, 1, 4, 1)); 
nameBox.add (instrument Label) ; 
} 
background.add(BorderLayout .EAST, buttonBox) ; 
background.add(BorderLayout .WEST, nameBox) ; 
ou 
frame .getContentPane () .add (background) ; <la out manager one peri th 
GridLayout grid = new GridLayout (16, 16); m ae components | a or" 
z ; v 
grid.setVgap (1); vows and columns: 


grid.setHgap (2) ; 


JPanel mainPanel new JPanel (grid) ; 
background. add (BorderLayout .CENTER, mainPanel) ; 


0; 


checkboxList 
for (int i 
JCheckBox c 


new ArrayList<>() ; 
i < 256; i++) { 
new JCheckBox () ; 


c.setSelected (false) ; Make the cheek boxes, set them is 
checkboxList .add (c); re (so the aren't checked) and 
mainPanel .add(c) ; a hem to l : ; 
} the GUI panel. ArrayList AND to 
frame.setBounds (50, 50, 300, 300); 
frame.pack () ; 
frame.setVisible (true) ; 
} 
private void setUpMidi() { 
try { 
sequencer = MidiSystem.getSequencer () ; ke a 
sequencer.open () ; Geaventer make 
Get the >e ke a Track- 
sequence = new Sequence (Sequence.PPQ, 4); enter an make 
track = sequence.createTrack () ; Sey 


sequencer .setTempoInBPM (120) ; 
} catch (Exception e) { 
e.printStackTrace () ; 


} 
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private void buildTrackAndStart() { 
ArrayList<Integer> trackList; // this will hold the instruments for each 


sequence .deleteTrack (track); awn through the : 
track = sequence.createTrack () ; Build a track by i: ies state and mapping 
for (int i = 0; i < 16; i++) { checkboxes $0 XT ent (and making AE a, 
trackList = new ArrayList<>() ; that to an m Y) This is Pre Oe a 
int key = instruments [i]; MidiEvent Lor LY as vk was ul a 
for (int j = 0; j < 16; j++) { but it is AC he Code Kita ae a 
JCheckBox jc = checkboxList.get(j + (16 * i)); chapters» so ve “a the full explanation 9 
if (jc.isSelected()) { Chapter to ge 
trackList.add (key) ; 
} else { 


} 


trackList.add(null); // because this slot should be empty in the track 


} 
makeTracks (trackList) ; 
track .add(makeEvent (CONTROL_CHANGE, 1, 127, 0, 16)); 


track .add(makeEvent (PROGRAM_CHANGE, 9, 1, 0, 15)); // - so we always go to 16 beats 
try { 


sequencer .setSequence (sequence) ; 

sequencer .setLoopCount (sequencer . LOOP_CONTINUOUSLY) ; 
sequencer .setTempoInBPM (120) ; 

sequencer.start (); 

catch (Exception e) { 

e.printStackTrace() ; 


} 

} 

private void changeTempo (float tempoMultiplier) { The Tempo Factor stales T 
float tempoFactor = sequencer.getTempoFactor () ; sequencer's tempo by the Factor 


sequencer.setTempoFactor (tempoFactor * tempoMultiplier) ; provided, slowing the beat down or 


speeding it up. 


private void sendMessageAndTracks() { 
boolean[] checkboxState = new boolean[256]; 
for (int i = 0; i < 256; i++) { 


} 


try { 


} 


JCheckBox check = checkboxList .get (i); 


qo eee is is new.-it’s a lot like the SimpleChatClient, except instead 

E a U a we De two objects (the 
Strin message and the beat pattern) and write those two 
objec to the socket output stream (to the server). 


out .writeObject (userName + nextNum++ + ": " + userMessage.getText () ) ; 
out .writeObject (checkboxState) ; 

catch (IOException e) { 

System.out.printin("Terribly sorry. Could not send it to the server."); 
e.printStackTrace() ; 


userMessage.setText ("") ; 
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public class MyListSelectionListener implements ListSelectionListener { 


public void valueChanged (ListSelectionEvent lse) { This is also 
if (!lse.getValueIsAdjusting()) { istSelee ue 
String selected = incomingList .getSelectedValue () ; us when ine isteney that tells 
if (selected != null) { on the list fre made 3 Select 
// now go to the map, and change the sequence the se x messages, Wher lon 
boolean[] selectedState = otherSeqsMap.get (selected) ; IMMED| ATE) €55ag6, we 
changeSequence (selectedState) ; beat. patter F ‘ the ae 
sequencer. stop() ; called i here it’s j é land 
; buildTrackAndStart () ; Playing ip oe start : 
elaus . Some j 
} Jetting a tle quirky thi se b 
} ele tionEvent, > about 


private void changeSequence (boolean[] checkboxState) { 
for (int i = 0; i < 256; i++) { This method i 
JCheckBox check = checkboxList.get (i); somethin 9 Crom sr T the user selects 
check. setSelected (checkboxState[i]) ; change the patter b i We IMMEDIATELY 
} he one they selected. 


public void makeTracks (ArrayList<Integer> list) { 
for (int i = 0; i < list.size(); i++) { 
Integer instrumentKey = list.get (i); 
if (instrumentKey != null) { 
track.add(makeEvent (NOTE_ON, 9, instrumentKey, 100, i)); 
track.add(makeEvent (NOTE_LOFF, 9, instrumentKey, 100, i + 1)); 


| . 
' All the MIDI stuff is exactly the same as it 


| was in the previous versions. 


public static MidiEvent makeEvent (int cmd, int chnl, int one, int two, int tick) { 
MidiEvent event = null; 
try { 
ShortMessage msg = new ShortMessage() ; 
msg.setMessage (cmd, chnl, one, two); 
event = new MidiEvent (msg, tick) ; 
} catch (Exception e) { 
e.printStackTrace() ; 
} 


return event; 
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public class RemoteReader implements Runnable { 
public void run() { 
try { 


} 


} 


} 


} 


Object obj; 

while ((obj = in.readObject()) != null) { 
System.out .printin("got an object from server"); 
System. out .printin (obj.getClass() ) ; 


String nameToShow = 
boolean[] checkboxState = 
otherSeqsMap.put (nameToShow, 


(String) obj; 
checkboxState) ; 


listVector .add(nameToShow) ; 
incomingList.setListData (listVector) ; 


} 


e.printStackTrace () ; 


Multi-cateh: if you want to eatth two 
different Exceptions but do the same 
thing with them (like here, we just want 
to print them out), you tan separate the 
two Exception classes with a pipe. 


(boolean[]) in.readObject 


d; messa e two i 
i 
checkbox nt pe ares jects (the 


Component, 
catch (IOException | ee tak rier is a 
ing: 
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it reads 


; thread jeo— In this 


the server: 


values) 7 


en a m 
essa 
deserialize) ry © Comes 


We want to ad values), w 


d to th 


k 
a Vector of the ists ye 
ettor is an old—L3shi 
ArrayList), and ther tell i 
the JList to use that 
Vettor as it’s source for 


what to display in the list. 
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iad your pencil —+ Yours to solve. 
IN 


What are some of the ways you can improve this program? 
Here are a few ideas to get you started: 


1. Once you select a pattern, whatever current pattern was playing is blown 
away. If that was a new pattern you were working on (or a modification of 
another one), you're out of luck. You might want to pop up a dialog box that 
asks the user if he'd like to save the current pattern. 


2. If you fail to type in a command-line argument, you just get an exception 
when you run it! Put something in the main method that checks to see if 
you've passed in a command-line argument. If the user doesn’t supply one, 
either pick a default or print out a message that says they need to run it 
again, but this time with an argument for their screen name. 


3. It might be nice to have a feature where you can click a button and it will 
generate a random pattern for you. You might hit on one you really like. 
Better yet, have another feature that lets you load in existing “foundation” 
patterns, like one for jazz, rock, reggae, etc., that the user can add to. 


You don't have to type all the code in! You can clone it from the repository at 
All the code is available at https://oreil.ly/hflava_3e_examples. 


There's also an alternative BeatBox solution, which uses Maps and Lists in- 
stead of the arrays used in this solution. There’s more than one way to solve 
any problem! 
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Final BeatBox server program 


Most of this code is identical to the SimpleChatServer we made in Chapter 17, 
Make a Connection. The only difference, in fact, is that this server receives, and 
then re-sends, two serialized objects instead of a plain String (although one of 
the serialized objects happens to be a String). 


import java.io.*; 
import java.net.*; 
import java.util.*; 


import java.util.concurrent.*; 


public class MusicServer { 
final List<ObjectOutputStream> clientOutputStreams = new ArrayList<>() ; 


cent, output 
~ ofall the tlient oute 


public static void main(String[] args) { List 4 essages 
new MusicServer ().go(); streams to sen m eceived- 
} when a message = 


public void go() { 

try { Oven as 
ServerSocket serverSock = new ServerSocket (4242) ; 

ExecutorService threadPool = Executors .newCachedThreadPool () ; 


at port ALAD 


ever sotket 


while (!serverSock.isClosed()) { 

Socket clientSocket = serverSock.accept () ; 

ObjectOutputStream out = new ObjectOutputStream(clientSocket .getOutputStream () ) ; 

clientOutput Streams. add (out) ; Keep listening for tlient 
Connections; create a 

ClientHandler clientHandler = new ClientHandler (clientSocket); new Socket and new 

threadPool.execute (clientHandler) ; ClientHandler- Bie es 

System.out.printin("Got a connection"); Connected client. 


} catch (IOException e) { 
e.printStackTrace () ; 


public void tellEveryone (Object one, Object two) { 
for (ObjectOutputStream clientOutputStream : clientOutputStreams) { 


try { 
clientOutputStream.writeObject (one) ; Send the message and the 
clientOutputStream.writeObject (two); beat pattern to all the 


} catch (IOException e) { 


e.printStackTrace () ; clients. 
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final BeatBox code 


public class ClientHandler implements Runnable { 
private ObjectInputStream in; 


Create an Object|nputStream for 
public ClientHandler (Socket socket) { sine gi i ae Tank 
try { 
in = 


new ObjectInputStream (socket .getInputStream() ) ; 
} catch (IOException e) { 


e.printStackTrace () ; 


} 


public void run() { 
Object userName; : 
Object beatSequence; When the tlient sends a message, it's j e 
ns of two parts: a String that contains the 


while ((userName = in.readObject () ) 


: != null) { sername and their message; and a pher 
beatSequence = in.readObject () ; that re vesents the beat sequente is 
at rep b Ł the server 
is attually a boolean array, bu 
System.out .printin ("read two objects"); ' ? + that). 
i doesn t care abou 
tellEveryone (userName, beatSequence) ; 
} 
} catch (IOException | ‘ieee dS 
e.printStackTrace () ; Onte we ve 9 4 th 
} e Sequence, s F essage and 
} e clients ln Pa these to all 
} ing this one) 
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Appendix B: 


The top ten-ish topics that didn't make 
it into the rest of the book... 


You mean, there's still 
MORE? Doesn't this 
book EVER end? 


We covered a lot of ground, and you're almost finished with this book. We'll miss you, but before 
we let you go, we wouldn't feel right about sending you out into JavaLand without a little more 
preparation. We can't possibly fit everything you'll need to know into this relatively small appendix. 
Actually, we did originally include everything you need to know about Java (not already covered by 
the other chapters), by reducing the type point size to .00003. It all fit, but nobody could read it. So, 
we threw most of it away, but kept the best bits for this Top Ten-ish appendix. Yep, there’s more than 


ten Really Useful Things that you still need to know. 


This really is the end of the book. Except for the index (a must-read)). 
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JShell REPL 


#11 JShell (Java REPL) 
Why do you care? 


A REPL (Read Eval Print Loop) lets you run snippets of 
code without needing a full application or framework. It’s 
a great way to try out new features, experiment with new 
ideas, and get immediate feedback. We’ve put this right at 
the start of this appendix in case you want to use JShell to 
try out some of the features we'll be talking about in the 
following pages. 


Starting the REPL 


JShell is a command-line tool that comes part of the JDK. If 
JAVA_HOME/bim is on your system’s path, you can just type 
“jshell” from the command line (full details on getting started 
are in Oracle’s Introduction to JShell (tips://orei. ly /E15 Df). 


%jshell 
| Welcome to JShell -- Version 17.0.2 


| For an introduction type: /help intro 


jshell> 


JShell is available only in JDK 9 and higher, but 

the good news is that even if you’re running code and 
applications on an older version of Java, you can still use 
JShell from a more recent version, since it’s completely 
independent of your “JAVA_HOME?” or IDE’s version 
of Java. Just run it directly from the bin directory of 
whichever version of Java you want to use. 


Run Java code without a class 


Try out some Java from the prompt: 


jshell> System.out.printin ("Hello") 
Hello 


jshell> 


Note: 
e No need for a class 
e No need for a public static main method 


e No need for a semicolon on the end of the line 


Just start typing Java! 
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Java 9+ 
More than just lines of code 


You can define variables and methods: 


File Edit Window Help RealJava 


jshell> String message = "Hello there " 
message ==> "Hello there " 


jshell> void greet (String name) { 
Does System.out .printl1n (message+name) ; 
ere} 

| created method greet (String) 


jshell> greet ("you") 
Hello there you 


eide 
À are needed insi 
on cole like methods: 


It supports forward references, so you can sketch out the 
shape of your code without having to define everything 
immediately. 
jshell> void doSomething() { 
> doSomethingEl1se () ; 
Siete ay 
| created method doSomething(), however, it 
cannot be invoked until method doSomethin- 
gElse() is declared 


Code suggestions 


If you press Tab halfway through typing, you'll get code 
suggestions. You can also use the up and down arrows to 
cycle through the lines you’ve typed so far. 

jshell> System.out.pr 
printf ( 


print ( 
jshell> System.out .print 


print1n( 


Commands 


There are lots of helpful commands that are part of JShell 
and not part of Java. For example, type /vars to see all 
the variables you’ve declared. Type /exit to, er, exit. 
Use /help to see a list of commands and to get more 
information. 


Oracle has a very useful JShell User Guide (https://oreil. by/ 
E13 Df), which also shows how to create and run scripts with 
JShell. 
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#10 Packages 
Packages prevent class name conflicts 


Although packages aren’t just for preventing name collisions, 
that’s a key feature. If part of the point of OO is to write reusable 
components, developers need to be able to piece together 
components from a variety of sources and build something new 
out of them. Your components have to be able to “play well with 
others,” including those you didn’t write or even know about. 


Remember way back in Chapter 6, Using the Java Library, when 
we discussed how a package name 1s like the full name of a class, 
technically known as the fully qualified name. Class List is really 
java.util. List, a GUI List is really java.awt. List, and Socket 
is really java.net.Socket. Hey presto, an example of how 


package names can help prevent name conflicts—there’s a List 
that’s a data structure and a List that’s a GUI element, and we 
can use the package names to tell them apart. 


Notice that these classes have java as their “first name.” In other 


words, the first part of their fully qualified names is “java”; io 
Socket 


event 


x 


think of a hierarchy when you think of package structures, and 


organize your classes accordingly. 


Preventing package name conflicts 


The standard package naming convention is to prepend every 


ArrayList FlowLayout 


What does this picture look like to 
you? Doesn't it look a whole lot like ActionEvent 


a directory hierarchy? 


class with your reverse domain name. Remember, domain names 
are guaranteed to be unique. Two different guys can be named 
Bartholomew Simpson, but two different domains cannot be named 


doh.com. xs 
me \ 
the apa Packages can prevent name 
alway? Í : 
Reverse domain package names conflicts, but only if you 


com.headfirstjava.projects.Chart choose a p ackage ame that's 
" N guaranteed to be unique. 
k wi our . : 
— Sul by a aaa might be a common [he best way to do that is to 
dot (.), and then add your own me, but adding comheadfirstjava ka e 
5 nl rubhave alter that. means we have to worry about only preface your pac ges with 


i our own in—house devel , 
Packages are lowercase evelopers your reverse domain name. 


. com.headfirstbooks.Book 
When you look at the code samples at Attps://oreil.ly/hffava _3e_ 


sew ~~ ‘ 
examples, you'll see we’ve put the classes into packages named after package name class al 
each chapter to clearly separate the examples. 
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#10 Packages, cont. 


To put your class in a package: 


@) Choose a package name @) Set up a matching directory structure 
We're using com.headfirstjava as our It's not enough to say your class is in a package 
example. The class name Is PackageExercise, by merely putting a package statement in the 
so the fully qualified name of the class is now code. Your class isn't truly in a package until you 
com.headfirst java.PackageExercise. put the class in a matching directory structure. 


So, if the fully qualified class name is 

. com.headfirst java.PackageExercise, you must put 
© Put a package statement in your class the I e oe code in direa 
It must be the first statement in the source named headfirstjava, which must be in a 
code file, above any import statements. There directory named com. 
can be only one package statement per source 
code file, so all classes in a source file must 
be in the same package. That includes inner 
classes, of course. 


package com.headfirstjava; 


import javax.swing.*; 


ly most Java nee 
public class PackageExercise { this folder is likely 
// life-altering code here be svt/ main/ java: 


} 


A note on directories 


In the Real World, source files and class files are usually kept in separate 
directories—you don’t want to copy the source code to wherever it’s running (a 
customer’s computer or the cloud), only the class files. 


The most common structure for Java projects 1s based off Maven’s* convention: 


package structure 


MyProject/src/main/java Application sources 


MyProject/src/test/java ‘Test sources 


The class files are placed elsewhere. Real enterprise systems usually use a build 
tool like Maven or Gradle to compile and build the application (our sample code 
uses Gradle). Each build tool puts the classes into different folders: 


Maven Gradle 
ar PackageExercise.java 
Application classes | MyProject/target/classes MyProject/out/production/classes 
Test classes MyProject/target/test-classes | MyProject/out/test/classes 


*Maven and Gradle are the most common build tools for Java projects. 
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#10 Packages, cont. 


Compiling and running with packages 


We don’t need to use a build tool to separate our classes and source 
files. By using the -d flag, you get to decide which directory the 
compiled code lands in, rather than accepting the default of class files 
landing in the same directory as the source code. 


Compiling with the -d flag not only lets you send your compiled class 
files into a directory other than the one where the source file is, but 

it also knows to put the class into the correct directory structure for 
the package the class is in. Not only that, compiling with -d tells the 
compiler to build the directories if they don’t exist. 


Compiling with the -d (directory) flag 


è | Do 
Stay in the source directory: 
Beane to ject (scans EM ot Ge directory where the .java 
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The —d flag tells the compiler, 
“Put the class into its package 
directory structure, using the 
class specified after the -d as 
the root directory. But...if the 
directories aren’t there, create 
them first and then put the class 
in the right place!” 


NOT ed down 
file is! 


Sjavac -d../classes com/headfirstjava/PackageExercise. java 
fs Sy the 
Tells the Compiler lo N w you have to speti y 
al 
compiled co "ie laine ha ~ PAT bo get to the aċtu 
in he classes directory, source tile- 


acre! Yes, it Knows. 
To compile all the .java files in the com.headfirstjava package, use: 


Sjavac -d ../classes com/headfirstjava/*.java 


Compiles ever 
ile in this directory 


Running your code 
ne Cnn Program from 


ny. 
%ed MyProject/classes Classes directory. 


%java com.headfirstjava.PackageExercise 


You MUST v; 
Give the full lifi 
see that and immedi Y qualified elass namel Th , 
I xpel ind di y named ¢ 
there it ihe directory named headfirst a 
Paki expects to find the élass. if pottirstjava 


, or eve . ity Do. 
y. nin ‘Classes,’ it won't work! 


) where 
) ) and in 
IS in the “tom” 


Y Source (java) 


PackageExercise.class 


lall still compile 


rom here 


P 


PackageExercise.java 
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#9 Immutability in Strings and Wrappers 


We talked about immutability in Chapter 18, and we'll 
mention immutability in the last item of this appendix. 
This section is specifically about immutability in two 
important Java types: Strings and Wrappers. 


Why do you care that Strings are immutable? 


For security purposes and for the sake of conserving 


memory (whether you’re running on phones, IoT devices, 
or the cloud, memory matters), Strings in Java are 
immutable. What this means 1s that when you say: 

String s = "0"; 

for (int i = 1; i < 10; i++) { 

s = s + i; 

} 
what’s actually happening is that you’re creating ten 
String objects (with values “0,” “O1,” “012,” through 
“0Q123456789”). In the end, s is referring to the String with 
the value “0123456789,” but at this point there are ten 
different Strings in existence! 


Similarly, if you use methods on String to “change” a 
String object, it doesn’t change that object at all; it creates 
a new one: 


String str = "the text"; 
String upperStr = str.toUpperCase() ; 


vase ste” a N Creates an 
new u ; changed; 1% 'S veturns a 
THE TEAS, String “i a ie ken String object 


How does this save memory? 


Reference É ih 


Whenever you make a new String, the JVM puts it into a 
special part of memory called the “String Pool” (sounds 
refreshing, doesn’t it?). If there is already a String in the 
pool with the same value, the JVM doesn’t create a duplicate; 
it refers your reference variable to the existing entry. So 
you won't have 500 objects of the word “customer” (for 
example), but 500 references to the single “customer” 
String object. 


String strl = "customer"; 
String str2 = "customer"; 
System.out .printin(strl == str2); 


are not only . 
be they re the same object 
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immutability makes reuse possible 


The JVM can get away with this because Strings are 
immutable; one reference variable can’t change a 
String’s value out from under another reference variable 
referring to the same String. 


What happens to unused Strings? 


Our first example created a lot of intermediate Strings 
that weren’t used (“01,” “012,” etc). These were placed 
in the String Pool, which is on the heap and therefore 
eligible for Garbage Collection (see Chapter 9). Strings 
that aren’t used will eventually be garbage-collected. 


However, if you have to do a lot of String manipulations 
(like concatenations, etc.), you can avoid the creation of 
unnecessary strings by using a StringBuilder: 


StringBuilder s = new StringBuilder ("0"); 

for (int i = 1; i < 10; i++) { 
s.append (i); 

} 

String finalString = s.toString(); 


This way, the single mutable StringBuilder is updated 
every time to represent the intermediate states, instead 
of ten immutable String instances being created and the 
nine intermediate Strings being thrown away. 


Why do you care that Wrappers are 
immutable? 


In Chapter 10, we talked about the two main uses of the 
wrapper classes: 


e Wrapping a primitive so it can act like an object. 
e Using the static utility methods (e.g., Integer.parseInt()). 


It’s important to remember that when you create a 
wrapper object like: 


Integer iWrap = new Integer (42); 


that’s it for that wrapper object. Its value will always 
be 42. There is no setter method for a wrapper 
object. You can, of course, refer iWrap to a different 
wrapper object, but then you'll have two objects. Once 
you create a wrapper object, there’s no way to change 
the value of that object! 


appendix B Top Ten Reference 


#8 Access levels and access modifiers (who sees what) 


Java has four access levels and three access modifiers. There are only three modifiers because the 
default (what you get when you don’t use any access modifier) is one of the four access levels. 


Access levels (in order of how restrictive they are, from least to most restrictive) 


; publie means any Code anywhere Can aċċess the publie thing (by 
public <—— thing” we mean ĉlass, variable, method, constructor, ete.). 


protected ¢—_ protected works just like default (code in the same package has access), EXCEPT it 
also allows subclasses outside the package to inherit the protected thing, 


default — default access means that only Code within the same package as 


the class with the default thing can access the default thing. 


<<— private means that only code within the same ¢lass can aċċess the private thing, 
Keep in mind it means private to the ¢lass, not private to the object. One Dog can 
see another Dog object’s private stuff, but a Cat can't see a Dog's privates. 


private 


Access modifiers 


public 
protected 


private 


Most of the time you'll use only public and private access levels. 


public 


Use public for classes, constants (static final variables), and methods that you’re exposing to 
other code (for example getters and setters) and most constructors. 


private 


Use private for virtually all instance variables, and for methods that you don’t want outside code 
to call (in other words, methods used by the public methods of your class). 


Although you might not use the other two (protected and default) much, you still need to know 


what they do because you'll see them in other code. 
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access levels 
#8 Access levels and access modifiers, cont. 
default and protected 


default 


Both protected and default access levels are tied to packages. Default access is simple—it means 
that only code within the same package can access code with default access. So a default class, for 
example (which means a class that isn’t explicitly declared as public) can be accessed by only 
classes within the same package as the default class. 


But what does it really mean to access a class? Code that does not have access to a class is not 
allowed to even think about the class. And by think, we mean use the class in code. For example, 
if you don’t have access to a class, because of access restriction, you aren’t allowed to instantiate 
the class or even declare it as a type for a variable, argument, or return value. You simply can’t 
type it into your code at all! If you do, the compiler will complain. 


Think about the implications—a default class with public methods means the public methods 
aren't really public at all. You can’t access a method if you can’t see the class. 


Why would anyone want to restrict access to code within the same package? Typically, packages 
are designed as a group of classes that work together as a related set. So it might make sense 
that classes within the same package need to access one another’s code, while as a package, only 
a small number of classes and methods are exposed to the outside world (1.e., code outside that 
package). 


OK, that’s default. It’s stsmple—if something has default access (which, remember, means no 
explicit access modifier!), only code within the same package as the default thing (class, variable, 
method, inner class) can access that thing. 


Then what’s protected for? 


protected 
Protected access is almost identical to default access, with one exception: it Experienced developers 


allows subclasses to inherit the protected thing, even if those subclasses are outside the Orn) e e 
package of the superclass they extend. That’s it. That’s all protected buys you—the writing libraries for other 


ability j n ara be nue ee superclass package, yet still inert developers to use wil] find 
pieces of the class, including methods and constructors. both default and prot d 
ecte 


Many developers find very little reason to use protected, but it is used in some 
designs, and some day you might find it to be exactly what you need. One of access levels very helpful. 


the interesting things about protected is that—unlike the other access levels — 


protected access applies only to inheritance. If a subclass-outside-the-package These access levels can 
has a reference to an instance of the superclass (the superclass that has, say, a ° 
á a ea *a Separate the internals of a 


protected method), the subclass can’t access the protected method using that 


superclass reference! The only way the subclass can access that method is by library from the API that 


inheriting it. In other words, the subclass-outside-the-package doesn’t have access 


to the protected method; it just has the method, through inheritance. other developers will call 
from their code. 
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#7 Varargs 


We saw varargs briefly in Chapter 10, Numbers Matter, when we looked at the String.format() method. You also saw 
them in Chapter 11, Data Structures, when we looked at convenience factory methods for Collections. Varargs let a method 
take as many arguments as they want, as long as they’re of the same type. 


Why do you care? 


Chances are, you won’t write many (or any!) methods with a vararg parameter. But you will likely use them, 
passing in varargs, since the Java libraries do provide helpful methods, like the ones we just mentioned, that can 
take as many arguments as they like. 


How can | tell if a method takes varargs? 
Let’s look at the API documentation for String.format(): 
static String format (String format, Object... args) 


The triple dot (...) says this is method takes an arbitrary number of Objects after the String argument, including 
zero. For example: Partes for the format) 


String msg = String. format ("Message"); method) but valid ‘name 


+ 4 
vararas ar: ument) 
String msgName = String.format ("Message for %s", name); One varar§ 3 


Tuo varargs arguments 


5 = 5 Ww Ww n 
String msgNumName String .format ("%d, messages for %s", number, name); sumber ana ame 


Methods that take varargs generally don’t care how many arguments there are; it doesn’t matter much. Consider 
List.off), for example. It doesn’t care how many items you want in the List; it will just use add all the arguments 
into the new list. 


Creating a method that takes varargs 


You will generally be calling a method that takes varargs, not creating it, but let’s take a look anyway. If you 
wanted to define your own method that, for example, printed out everything passed into it, you could do it 
like this: 


void printAllObjects (Object... elements) { 
for (Object element : elements) { 
System. out .printin (element) ; 
} 
} 


The parameter elements is nothing magic; it’s actually just an array of Objects. So you can iterate over it the same 
way as if you’d created the method signature as: 


void printAllObjects (Object[] elements) { 


It’s the calling code that looks different. Instead of having to create an array of objects to pass in, you get the 
convenience of passing in an arbitrary number of parameters. 


Rules 


e A method can have only one varargs parameter. 


e The varargs parameter must be the last parameter. 
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#6 Annotations 


Why do you care? 


We very briefly mentioned annotations back in Chapter 
12, Lambdas and Streams: What, Not How, when we said 

that interfaces that can be implemented as a lambda 
expression may be marked with a “@Functionallnterface” 
annotation. 


Adding an annotation to your code can add extra 
behavior, or an annotation can be a kind of compiler- 
friendly documentation; i.e., you’re simply tagging 
the code with some additional information that could 
optionally be used by the compiler. 


You will definitely see annotations used in the Real World, 
and very likely use them. 


Where will you see annotations? 


You will see annotations in code that uses libraries and 
frameworks like Java EE/Jakarta EE, Spring/Spring Boot, 
Hibernate and Jackson, all of which are very commonly 
used in the Java world for building large and small 


applications. c ass-level annotation 


@SpringBootApplication <— 

public class HelloSpringApplication { 
Where you will definitely see annotations is in test code. 
Back in Chapter 5, Extra-Strength Methods, we introduced 
the idea of testing your code, but what we haven’t shown 
is the frameworks that make it much easier. ‘The most 
common one is JUnit. If you look at the code samples at 
hitps://oreil. ly/hffava_3e_examples, you'll see there are some 
example test classes in the “test” folder. 


@Test £—Method-level annotation 
void shouldReturnAMessage() { 


Annotations can he applied to classes 
and methods, to variables (Jocal and 
instance) and parameters, and even 
some other places in the code. 
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Annotations can have elements 


Some annotations include elements, which are like 
parameters with names. 


@Table (name="cust") 
public class Customer { 


If the annotation has only one element, you don’t need to 
give the name. 


@Disabled("This test isn't finished") 
void thisTestIsForIgnoring() { 


As you saw in the earlier examples, you don’t need to add 
y ples, y 
parentheses to an annotation that doesn’t have elements. 


You can add more than one annotation to the class, 
method, or variable that you’re annotating. 


What do they do? 


Well, it depends! Some can be used as a sort of compiler- 
safe documentation. If you add @FunctionalInterface to 
an interface with more than one abstract method, you'll 
get a compiler error. 


Other annotations (like @NotNull) can be used by your 
IDE or by analysis tools to see if your code is correct. 


Many libraries provide annotations for you to use to tag 
parts of your code so the framework knows what to do 
with your code. For example, the @Test annotation tags 
methods that need to be run as individual tests by JUnit; 
@SpringBootApplication tags the class with the main 
method that’s the entry point of a Spring Boot application; 
@Entity tags a Java class as a data object that needs to be 
saved to a database by Hibernate. 


Some annotations provide behavior on top of your code. 
For example, Lombok can use annotations to generate 
common code: add @Data to the top of your class, and 
Lombok will generate constructors, getters and (if needed) 
setters, and hashCode, toString, and equals methods. 


Sometimes annotations seem to work like 
magic! The code that does the hard work 
is hidden away. If you use annotations 
that are well documented, you’ll have a 


better understanding of what they do and 
how they work. This will help you fix any 
issues you may run into. 
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#5 Lambdas and Maps Java 8+ 
Why do you care? 


Java 8 famously added lambdas and streams to Java, but what is less well-known 

is that java.util.Map also got a few new methods that take lambda expressions as 
arguments. These methods make it much easier to do common operations on Maps, 
which will save you time and brainpower. 


Create a new value if there isn’t one for the key 


Imagine you want to track what a customer does on your website, and you do this 
using an Actions object. You might have a Map of String username to Actions. When 
a customer performs some action that you want to add to their Actions object, you 
want to either: 


e Create a new Actions object for this customer and add it to the Map 
e Get the existing Actions object for this customer 


It’s very common to use an zf statement and a null check to do this (pre-Java 8): 


Map<String, Actions> custActs = new HashMap<>(); , ; 
// probably other stuff happens here... See if there's an Aetions 


a object for the username. 
Actions actions = custActs.get (usr); 


if (actions == null) { ake value doesn t enst 


etions and 
actions = new Actions (usr); --S0 create a en the 


custActs.put (usr, actions); add it to the k 
} username as the key: 


// do something with actions 


It’s not a lot of code, but it is a pattern that is used again and again. If you’re using 
Java 8 or higher, you don’t need to do this at all. Use computelfAbsent, and give 
it a lambda expression that says how to “compute” the value that should go into the 
Map if there isn’t an entry for the given key: 


. sett 
E the Actions objet 
the existing Actions ape A in the Map: 
~ This is EITHER 


= 1 t \ t e 
ctions tv eated b he ambda if he us name wasn 


custActs.computeIfAbsent (usr, name -> new Actions (name) ); 


This lambda says how to ereate a 
value lan Actions) if the peas ad 
doesn’t have an Actions in the Map yet. 
i is the key we're 
ing for in the Map. 
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#5 Lambdas and Maps, cont. 


Update the value only if it already exists 


There may be other scenarios when you want to update a value in the Map only if it exists. For 
example, you might have a Map of things that you are counting, like metrics, and you want to 

update only the metrics that you care about. You don’t want to add any arbitrary new metric to 
the Map. Before Java 8, you might use a combination of contains, get, and put to check if the map 
has a value for this metric and update it if so. 


À m the 
Map<String, Integer> metrics = new HashMap<>() ; S {the orn ts aa bey n the 
// probably other stuff happens here... ee oe, . a 
yee if the result is null or not 
and see ! 


if (metrics.containsKey(metric)) { 
Integer integer = metrics.get (metric); <|f£ it’s in the map, get the value. 
metrics.put (metric, ++integer); <— Intremend th 


} it baek in ate and put 


Java 8 added computelfPresent, which takes the key you’re looking for and a lambda 
expression, which you can use to describe how to calculate the updated value for the Map. 
Using this, the code above can be simplified to: 


metrics.computeIfPresent (metric, (key, value) -> ++value); 


ik th 
turns the new value £ the t ‘ The lambda 


This also ve \\ if not), bu Parameters are th 

; map Sor nu : and th e the ke 
ee ddt ae Ke or owr example: This is the age taleulate ns and we tan use these to 
we . 


were looking 


new value [F the key exists 


in the map. 


Other methods 


There are other, more advanced methods on Map that can be useful when you want to “add 
a new value OR do something with the existing value” (or even remove a value), like merge 
and compute. There’s also replaceAll, which you can give a lambda expression that calculates a 
new value for all the values in the map (we could use this, for example, to increment ALL the 
metrics in our previous example, if we needed to). And, like all the collections, it has a forEach 
that lets us iterate over all the key/value pairs in the Map. 


The Java libraries continuously evolve, so even if you think you understand something you’ve 
used a lot, like List or Map, it’s always worth keeping an eye out for changes that may make 
your life easier. 


Remember, the Java API documentation (https://oreil.ly/In5xn) is a great place to start if you 
want to see what methods are available on a class, and what they do. 
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#4 Parallel Streams 


Back in Chapter 12, Lambdas and Streams: What, Not How, 
we took a long look at the Streams API. We did not look 
at one of the really interesting features of streams, which 
is that you can use them to take advantage of modern 
multicore, multi-CPU hardware and run your stream 
operations in parallel. Let’s look at that now. 


So far, we’ve used the Streams API to effectively “query” 
our data structures. Now, imagine those data structures 
can get big. We mean REALLY big. Like all the data from 
a database, or like a real-time stream of data from a social 
media API. We could plod over each of these items one by 
one, in serial, until we get the results we want. Or, we 
could split the work up into multiple operations and run 
them at the same time, in parallel, on different CPUs. 
After Chapters 17 and 18 you might be tempted to run off 
and write a multithreaded application to do that, but you 
don’t have to! 


Going parallel 


You can simply tell the Streams API you want your stream 
pipeline to be run on multiple CPU cores. There are two 
ways to do this. 
: Remember our mock ae 
data from Chapter 14 
getSongs (); 

songs .parallelStream () ; 


1. Start a parallelStream 


List<Song> songs = 
Stream<Song> par = 


2. Add parallel() to the stream pipeline 


List<Song> songs = 
Stream<Song> par = 


getSongs (); 
songs.stream() 
-parallel (); 


They both do the same thing, and you can choose 
whichever approach you prefer. 


OK now what? 


Now, you just write a stream pipeline just like we did in 
Chapter 12, adding the operations you want and finishing 
off with a terminator. The Java libraries will take care of 
figuring out: 


e How to split the data to run the stream pipeline on 
multiple CPU cores 


e How many parallel operations to run 


e How to merge the results of the multiple operations 
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Multithreading is taken care of 


Under the covers, parallel streams use the Fork-Join 
framework (which we did not cover in this book; see 
hitps://oreil. ly/Xf6eH), yet another type of thread pool 
(which we did talk about in Chapter 17, Make a Connection). 
With parallel streams, you'll find the number of threads 

is equal to the number of cores available wherever your 
application is running. There are ways to change this setup, 
but it’s recommended to stick with the defaults unless you 
really know what you’re doing. 


Do not use parallel everywhere! 


Before you going running off and making all your stream 
calls parallel, wait! Remember we said back in Chapter 18, 
Dealing with Concurrency Issues, that multithreaded programming 
was hard, because the solutions you choose depend a lot on 
your application, your data, and your environment? The 
same apples to using parallel streams. Going parallel and 
making use of multiple CPU cores is not free and does not 
automatically mean your application will run faster. 


There is a cost to running a stream pipeline in parallel. The 
data needs to be split up, the operations need to be run on each 
bit of data on separate threads, and then at the end the results 
of each separate parallel operation need to be combined in 
some way to give a final result. All of that adds time. 


If the data going into your stream pipeline is a simple 
collection, like the examples we looked at in Chapter 12 
(indeed, in most places streams are used today), using serial 
streams is almost definitely going to be faster. Yes, you read 
that correctly: for most ordinary use cases, you do not 
want to go parallel. 


Parallel streams can improve performance when: 


e The input collection is BIG (think hundreds of 
thousands of elements at least) 


e The stream pipeline is performing complicated, long- 
running operations 


e The decomposition (splitting) of the data/operations 
and merging of the results are not too costly. 


You should measure the performance with and without 
parallel before using it. If you want to learn more, Richard 
Warburton’s Java 8 Lambdas book has an excellent section 
on data parallelism. 
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#3 Enumerations (also called enumerated types or enums) 


We’ve talked about constants that are defined in the API, for instance, JFrame 
.EXIT_ON_CLOSE. You can also create your own constants by marking a variable 
static final. But sometimes you'll want to create a set of constant values to 
represent the only valid values for a variable. This set of valid values is commonly 
referred to as an enumeration. Full-fledged enumerations were introduce way back 


in Java 5. 
Who’s in the band? 


Let’s say that you’re creating a website for your favorite band, and you want to make 
sure that all of the comments are directed to a particular band member. 


The old way to fake an “enum”: 


public static final int KEVIN = 1; 
public static final int BOB = 2; 
public static final int STUART = 3; 


We're hoping that by the time we got here 


i 4 
fi dater in the gode ‘selectedBandMember” has a valid value! 


if (selectedBandMember == KEVIN) { 
// do KEVIN related stuff 


The good news about this technique is that it DOES make the 
code easier to read. The other good news is that you can’t ever 
change the value of the fake enums you’ve created; KEVIN 
will always be 1. The bad news is that there’s no easy or good 


way to make sure that the value of selectedBandMember n 
will always be 1, 2, or 3. If some hard-to-find piece of code This IS the OLD way to fake an 
sets selectedBandMember equal to 812, it’s pretty likely enum, but you will stil] see code 


your code will break. like this in Real Life (e.g., the 
older Java libraries like AWT). 


However, if you have any 
contro] over the code, try to use 
enums instead of constants like 
this. See the next page... 


696 appendix B 


appendix B Top Ten Reference 


#3 Enumerations, cont. 


Let’s see what the band members would look like with a “real” enum. While this is 


ekinition 
a very basic enumeration, most enumerations usually are this simple. of odk kea § yle ane à à 
-ui ooks k enum ew 
An official “enum” Peas Mine ne aut ES e created a” 
olsn cla “ er 
: o Mem 
public enum Member { KEVIN, BOB, STUART }; seval K Lyre call a 
enun 


public class SomeClass { 
public Member selectedBandMember; 


// later in the code... i The “seleetedBandMembey-” variable is ot type 


void someMethod() { “Member,” and ea 
if (selectedBandMember == Member.KEVIN) { “KEVIN,” “BoB,” ee = 


// do e stuff NS 
} 


Th KA » 
} No need to worry about this variable’s value! € syntax to refer to an enum instance 


Your enum extends java.lang.Enum 


When you create an enum, you’re creating a new class, and you’re implicitly extendin 
=| 3 
java.lang.Enum. You can declare an enum as its own standalone class, in its own source 


file, or as a member of another class. 


Using “if” and “switch” with enums 


Using the enum we just created, we can perform branches in our code using either the if or 
switch statement. Also notice that we can compare enum instances using either == or the 
. equals method. Usually == is considered better style. 


Member member = Member.BOB; ee 


Assigning an enum value to a variable 


if (member.equals (Member.KEVIN) ) of these work Finel 
System.out.println("Bellloooo!"); Both ea 
.. printed: 
if (member == Member.BOB) “Poothy 1s T 


System.out.printin("Poochy") ; 


switch (member) { -— Pop Quiz! What’s the output? 
case KEVIN: System.out.print ("Uh... la cucaracha?"); 

case BOB: System.out.println ("King Bob"); 

case STUART: System.out.print ("Banana!"); 


} 


You can add a bunch of things to your enum like a constructor, methods, variables, ieie 
and something called a constant-specific class body. They’re not common, but you l q 


might run into them. Answer: rd burrs 
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#2 Local Variable Type Inference (var) 


If you’re using Java 10 or higher, you can use var when 
youre declaring your local variables (1.e., variables inside 
methods, not method parameters or instance variables). 


var name = "A Name"; ame is a String 


This is another example of type inference, where the 
compiler can use what it already knows about the types to 
save you from writing more. The compiler knows name is 
a String because it was declared as a String on the right 
hand side of the equals sign. 


An precayList 
var nakas. = new ArrayList<>(); 
var customers = getCustomers (); 


Ci getCustomerst) returns List<Customer>> 
this is a List<Customer>- 


Type inference, NOT dynamic types 


When you declare your variable using var, it still has a 
type. It’s not a way of adding dynamic or optional types 
to Java (it’s not like Groovy’s def). It’s simply a way of 
avoiding writing that type twice. 
You do have to somehow tell the compiler what the type is 
when you declare the variable. You can’t assign it later. So, 
you can’t do this: 

var name; Does NOT compilel! 
because the compiler has no idea what type name is. 
It also means that you can’t change its type later: 


var someValue = 1; R I 
someValue = "String"; — Does NOT compile.. 


Someone has to read your code 


Using var does make the code shorter, and an IDE can tell 
you exactly what type your variable is, so you might be 
tempted to use var everywhere. 


However, someone reading your code might not be using 
an IDE or have the same understanding of the code as 
you. 


We did not use var in this book (even though it would 
have been easier to fit the code on the pages), because we 
wanted to be explicit to you, the reader, about what the 
code was doing. 
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Tip: Better with useful variable names 


If you don’t have the type information visible in the code, 
descriptive variable and method names will be extra 
helpful to a reader. 


var reader = newBufferedReader (get ("/") ); 
var stuff = doTheThing(); 


We have NO IDEA what this is 
Tip: Variable will be the concrete type 


In Chapter 11 we started “programming to interfaces”; 
i.e., we declared our variables as the interface type, not the 
implementation: 


List<String> list = new ArrayList<>(); 


If you’re using var, you can’t do this. The type will be the 
type from the right-hand side: 


var list = new ArrayList<String> (); 


“eis an . 
Tt car 


Tip: Don’t use var with the diamond 
operator 


Look at the last example. We declared list first as a 
List<String> and used the diamond operator (<>) on the 
right-hand side. The compiler knows the type of the list 
element is a String from the lefthand side. 


If you use var, like we did in the second example, the 
compiler no longer has this information. If you want the 
list to still be a list of Strings, you need to declare that on 
the righthand side; otherwise, it will contain Objects. 


var list = new ArrayList<>() ; b 

List<Oojeer 

a is an À pe you wanted 
probabl o. 


Read all the style guidelines from the OpenJDK developers 
(https://oreil.ly/e VfSd). 


#1 Records 
Why do you care? 


A “simple” Java data object is often not simple at all. Even 
a data class (sometimes called a Java Bean, for historical 
reasons) with only a couple of fields requires quite a lot 
more code than you might expect. 


A Java data class, before Java 16 


Imagine a basic Customer class, with a name and an ID: 


public final class Customer { 
private final int id; 
private final String name; 


public Customer(int id, String name) { 
this.id = id; 
this.name = name; 


} 


public int getId() { 
return id; 


} 


public String getName() { 
return name; 


} 
public boolean equals (Object o) { } 
public int hashCode() { } 


public String toString() { } 
} 


We've left out the details of the equals, hashCode, and 
toString methods, but you would probably want to 
implement those methods, especially if you’re going to 

use this object in any collections. We’ve also left off the 
“setters”; this is an immutable object with final fields, but in 
some cases you might want setters as well. 


That’s a lot of code! It’s a simple class with two fields, and 
the full code, including implementation, is 41 lines! 


Don’t use “ 
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What if there was a special syntax 
for data classes? 


Guess what? If you’re using Java 16 or higher, there is! 
Instead of creating a class, you create a record. 


These are the vetord’s 
components- These translate 
into instance variables and 
an attessor method tor the 
variable. 


a ~—*—-n~ 


public record Customer(int id, String name) {} 


is retord header also defines what 
ae looks like (the — 
the parameters for the constructor). 


» 
class,” use “record.” 


That’s it. That’s all you need to do to replace the 42 lines of 
code of the “old” Customer data class. 


A record like this one has instance variables, a constructor, 
accessor methods, and equals, hashCode, and toString methods. 


Using a record 


When you're using a record that’s already been defined, it 
looks exactly the same as it would if the record class was a 
standard data class: 


Customer customer = new Customer(7, "me") ; 
System. out .printi1n (customer) ; 
System. out .printi1n (customer .name () ) ; 
Notite this ; 
The output looks like: e this is No 
P getName(), r 
%java UsingRecords Records have 3 pretty 


toString by de ault. 


Customer [id=7, name=me] 
me 


Goodbye “get” 


Did you notice something? Records don’t use the classic 
“get” prefix for the methods that let you read the instance 
variables (hence we carefully called them “accessors” 

and not “getters”). They just use the name of the record 
component as the method name. 
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#1 Records, cont. 


You can override constructors 


The constructor, accessors, and equals, hashCode, and 
toString methods are all provided by default, but you can 
still override their behavior if you need something specific. 


Most of the time, you probably won’t need to. But if you 
want, for example, to add validation when you create the 
record, you can do that by overriding the constructor. 


public record Customer(int id, String name) { 
public Customer(int id, String name) { 
if (id < 0) { 
throw new ValidationException () ; 
} 
this.id = id; 


this.name = name; 


} 


Actually, it’s even easier than that. The example above 

is a canonical constructor, i.c., the normal kind of 
constructor we’ve been using everywhere. But records also 
have a compact constructor. This compact constructor 
assumes all the normal stuff is taken care of (having the 
right number of parameters in the right order, and all 
assigned to the instance variables) and lets you define only 


the other stuff that matters, like validation: 
Sines what the . 
3 you call it 


public record Customer (int id, String name) { 


No need to define the 
public Customer { ¢onstructoy Parameters 


eo ; 
if (id < 0) { Can still access the parameters 
throw new ValidationException () ; 


} No need to assign anything to 


} the instance variables 


} 


When you call the Customer’s constructor, you still need 
to pass it an ID and a name, and they will still be assigned 
to the instance variables (that’s all defined by the record 
header). All you need to do to add validation to the 
constructor is use the compact form and let the compiler 
take care of all of the rest. 


Customer customer = 


Even with a compact constructor you must pass 
in arguments for all of the record components. 


new Customer(7, "me") ; 
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You can override or add methods 


You can override any of the methods and add your own 
(public, default, or private) methods. If you are migrating 
existing data classes to use records, you may want to keep 
your old equals, hashCode, and toString methods. 


public record Customer (int id, String name) { 


public boolean equals (Object o) { 
return id == ((Customer) o).id; 
} Overrides the equals method to 
provide custom behavior 
private boolean isValidName (String name) { 


// some implementation 
} Records can have 


} normal 


You can create a protected method; the compiler won’t stop 
you, but there’s no point—records are always final classes 
and can’t be subclassed. 


Records are immutable 


In Chapter 18, we talked about making data objects 
immutable. Immutable objects are safer to use in concurrent 
applications, because you know that it’s impossible for more 
than one thread to change the data. 


It’s also easier to reason about what’s happening in your 
application if you know the data classes can’t change, so 
even in applications that aren’t multithreaded, you may 
find immutable data objects being used. And in #9 in this 
appendix we saw how immutability in Strings can save 
memory. 


Records are immutable. You can’t change the values in 

a record Object after you have created it; there are no 
“setters” and no way to change the instance variables. You 
can’t access them directly from outside the record, only 
read them via the accessor method. 


If you try to change one of the record’s instance variables 
from inside the record, the compiler will throw an 
exception. A record’s instance variables are final. 


Find out more about records in Oracle’s Record Classes 
documentation (https://oreil. ly/D7fh3). There, you can 

also read about some of the other new language features 
available in Java 17 that we didn’t get a chance to cover, like 
Pattern Matching, Sealed Classes, Switch Expressions, and 
the very useful Text Blocks. 
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!= and ! (not equals) 151 

% percent sign in format String 297—300 

&&, || Cand’ and ‘or’ operators) 151 

++ -- (increment/decrement) 106, 115 

-> (arrow operator) for lambda expressions 388 
. (dot operator) 36, 54, 61, 80 

// (comment syntax) 12 

:: (method reference) 408 


< (less than operator) 13 


<=, ==,!=, >, >= (comparison operators) 13, 86, 151, 
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<> (diamond operator) 312-313, 698 
= (assignment operator) 13 
== (equals operator) 13, 86, 348 
> (greater than operator) 13 
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abandoned objects. See garbage collection 


abstract classes 202-209 
conditions for using 229 
constructors in 253 
interface implementation 226 
and polymorphism 199, 208-209 
and static methods 278—282 


abstract class modifier 202 
abstract methods 205-206, 222, 226, 396 
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access levels 192, 193, 689-690 

access modifiers 81-82, 251, 689-690 
Accessors and Mutators. See Getters and Setters 
ActionEvent 467—468, 481—482, 523 
ActionListener 481, 482, 491 
actionPerformed() 467, 481, 482 
addActionListener() 467—469 

add(anObject), ArrayList 137 

Advice Guy 598-599 

alphabetical (natural) ordering in Java 315 
‘and’ and ‘or’ operators (&&, ||) 151 
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annotations 692 
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arguments 74, 76 
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catch 428 
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casting 231 saving drum pattern 579-582 
containing references of type Object 213-215 saving objects 540 

diamond operator 312-313 server program 681—682 

as generic class 322-323 behavior of an object. See methods 


HashSet instead of 347 
relationship to List in sorting project 310 
StartupBust object 142 


BindException 593 
Boolean anyMatch 377 


type parameters with 323 Boolean expressions 13 
and value of generics 320, 321 autoboxing with 292 
arrays 19, 59-62 not equals (!= and!) 151 
versus ArrayList 137—140 querying collection for values 410 
behavior of objects in 83 variables as incompatible with integers 14 
for declaring multiple return values 78 boolean primitive type 51, 53 
dot operator in 61 BorderLayout manager 478-482, 511, 513, 514-517 


Pane es o 22 Bottle Song application 16 
polymorphic 188 
SimpleStartupGame bug fix 128-130 BoxLayout manager 513, 521 


branching (if/else) 12 


assignment 
arrays 60 break statements 105 
autoboxing 293 BufferedReader 566, 594 


lambda expression variables 394 BufferedWaiter 565,572 
object 55, 186-188 
primitive variables 52 buffers 565, 566 
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BeatBox app 422 catch argument 428 
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reading/receiving with 594—596 
SocketChannel 591, 594, 595, 596-602 

character (%c) formatting type 301 

char primitive type 51, 53 

Chat client app 588-589, 604—608, 632-633 

Chat server app 588-589, 606—608 

check.addItemListener(this) 526 

check box (JCheckBox) 526 

checked versus runtime exceptions 430 

checkUserGuess() 145 

checkYourself() 102, 104, 130 


classes 8, 28, 41, 72. See also inheritance 
abstract. See abstract classes 
Animal simulation program 173, 174 
concrete 202-212 
conditions for making 229 
and constructors 243 
deserialization and versioning 556—557 
designing 34 
documentation 162 
efficiency of not saving with object 553 
elements of 7 
Executors 615 
File 564 
Files 572-573 
final 285, 286 
full names in Java library 155-157 
generic 321-323, 328-330 
Graphics2D 474—475 
hierarchy design with inheritance 175 
for immutable data 658, 661 
implementing multiple interfaces 228 
inner. See inner classes 
instance variable declarations inside 238 
and Java API packages 154-162, 685, 686 
JComponent 510 
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with main() 9 
Math 276-280 
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versus objects 35 
Object superclass 210-217 
Paths 572-573 
PetShop program class tree modifications 221—228 
Random 111 
records 699-700 
Sequencer 424—427 
Simple Startup Game 99-124 
and static variables 283 
tester class 36 
Thread 609-610 
and types 50 
without type parameters 324 
client application, networking 588—600, 604-608, 
632-633 


client-server relationship 589-593 


Code Kitchens 
BeatBox app 674-682 
GUI for Beatbox 528-533 
music with graphics 496-503 
playing sound 445-453 
saving BeatBox pattern 579-582 
collect() 377, 378, 410 
Collection API 345-346, 376 


collections 
ArrayList. See ArrayList 
common operations 374 
and concurrency 662—666 
count operation on 410 
enhanced for loop 116 
factory methods 356-357 
generics for type-safe 320-324 
List. See List interface 
Map 355, 409 
parameterized types 137 
streams as queries 385, 387 
Collections class 314, 323 
Collections.sort() 314-315 
Comparator 331-338 
compare() 333 
and List.sort() 332 
with Objects instead of Strings 317-319 
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Collectors class 378, 383, 387, 409 
Collectors.joming 409 

Collectors.toList 387, 409 

Collectors.toMap 409 

Collectors.toSet 409 
Collectors.toUnmodifiableList 356, 387, 409 
Collectors.toUnmodifiableMap 409 
Collectors.toUnmodifiableSet 409 
command-line arguments, MIDIEvent 452 
commas, formatting large numbers with 296, 298 
comment syntax (//) 12 

compact constructor 700 


Comparable interface 354 
Collections.sort() 327—330 
versus Comparator 332, 335 


Comparator interface 
as SAM type 397 
versus Comparable 332, 335 
lambda expressions with 341—343, 390-394 
and method reference 408 
sorting with 314, 331-338 
and TreeSet 354 


compare() 332, 333, 341 
compareAndSet method 655-656 
compare and swap operations. See CAS 
compareTo() 329-330, 332, 352 
comparison operators 13, 86, 151, 348 
compiler 2, 10—11, 687 

compiler-safe documentation, annotations as 692 
computelfAbsent 693 
computelfPresent 694 

concatenated objects 19 

concrete classes 202—212 


concurrency 639-669 
atomic variables 655-657 
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collections 662—666 
immutable objects 658-661 
locking 645 

lost update scenario 650-653 
multithreading 630 

race conditions 641—643 
synchronization 646-654 
trade-offs in 666 


ConcurrentModificationException 663 
conditional branching 15 

conditional expressions 13, 15 
conditional test, for loop 114 
connection, client-server 591—593 
connection streams 543 

constants 41, 284, 696 


constructors 243—259 
chaining 253-259 
in deserialization 552 
function of 244 
initializing state of object 245-248 
overloaded 258-259 
overriding 700 
private 191, 251, 278, 282 
review 251 
superclass 252-259 
containers (background components), GUI 510, 511 
contains() 403 
contract 
modifying class tree 220—226 
public methods as 192—193, 219 


ControllerEvent 497, 500 

convenience methods 357—358, 387 
CopyOnWriteArrayList 665—666 
CountDownLatch 625 

count operation, on collections 410 

C programming language 56 

curly braces ({}), for classes and methods 12 


D 


DailyAdviceServer 602 

data structures. See collections 

date formatting 302 

DDD (Deadly Diamond of Death) 225 
-d (directory) flag 687 

deadlock, synchronization 654 
decimal (%d) formatting type 301 


declarations 
exceptions 426, 441-443 
method 78, 144, 205-206, 222, 238 
object 186-188 
variable 50-52, 54, 84, 85, 116, 144, 238 


default access level 689, 690 
default method 396 


default value 
instance variable 84 
static variable 283 


deserialization 551—557 
diamond operator (<>) 312-313, 698 


directories 
File object with 564 
packages 573, 686 


distinct(), Stream 375, 406—407 

dot operator (.) 36, 54, 61, 80 

double primitive type 51, 53 

drawing 2D graphics 471, 472—475, 501-503 
Duck constructor 243—248, 250-251, 281—283 
ducking exceptions 441-443 

duplicate code, avoiding with inheritance 184 


duplicate results, removing 406—407 


E 


e-flashcards example, saving to text file 560 
encapsulation 80-82 
enhanced for loop 106, 116 
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enumerations 696—697 
equality 348, 349 
equals() 86, 349-351, 697 
equals operator (==) 13, 86, 348 
event handling 465—471 
getting graphics 477 
JCheckBox 526 
JList 527 
listener interface 466—469 
MIDIEvents 449-452, 497-503 
static methods 498—499 
event object 470 
event source 467—469 


exception handling 421, 426-444 
finally block 433, 444, 574-575 
flow control 432—433 
multiple exceptions 438 
try/catch blocks. See try/catch blocks 
try-with-resources statement 576-577 

exceptions 
BindException 593 
catching, See try/catch blocks 
checked versus runtime 430 
concurrency and collections 663 
declaring 436, 441-443 
ducking 441-443 
methods 425 
multiple 435 
NumberFormatException 294 
as polymorphic 436 
throwing 429-432 

Executors 626 

Executors class 615 

ExecutorService 615, 626-629 

ExecutorService.shutdown() 615, 629 


ExecutorService.shutdownNow() 629 


exercises 
Be the... 21, 42, 63, 88, 118, 195, 306, 363, 395, 505 
Code Magnets 20, 43, 64, 119, 163, 386, 455, 583, 
634 
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Mixed Messages 23, 194, 372 instance versus static variables 304-305 
Popular Objects 269 JVM and compiler roles 10-11 
Sharpen Your Pencil 5—6, 15, 37, 52, 87, 107, 134— variable discussion on life and death 266—267 


141, 145-147, 207, 250-251, 259, 287, 293, 334, 


floating point (%f) formatting type 301 
343, 353, 397, 431, 434, 440, 493, 502-503, 580, 


600-601 float primitive type 51, 53 
True or False 307, 454, 582 flowchart for Sink a Startup 97 
What's the Declaration? 233 flow control, exceptions 432—434 


What’s the Picture? 232 


i FlowLayout manager 513, 518-520 
Which Layout? 534-535 


Who Am I? 45, 89, 504, 631 forEach() 370, 388, 393, 694 

Who Does What? 374 Fork-Join framework 695 
explicit cast 78 for loops 114-116 
extending classes. See inheritance enhanced 106, 116 


versus forEach() 370-373 
SimpleStartup class 105 


format() 298 
F format specifiers 297—298, 300-302 


Formatter class 296 


extends keyword 328-330 


Extreme Programming 101 


factory methods 356-358, 387, 615 
File class 564 
FileInputStream 551 


formatting numbers 296-302 
frames, GUI 462, 511, 522 


Friesen, Jeff 


File object 564 Java I/O, NIO and NIO.2 597 
FileOutputStream 542, 543 


FileReader 566 
Files class 572—573 


fully qualified name, Java library packages 155-157 
@FunctionalInterface annotation 396 
functional interface, lambda expression 389-396 


files, source file structure 7 Function, in map method 405 


FileWriter 559, 565 

filter) 400-403 G 

filter streams. See chained streams GameHelper class 112, 142, 152-153 
final keyword GameHelper object 143 


adding to field declaration 660, 666 


Garbage-Collectible Heap 238 
classes 191, 285, 286 


methods 191. 285 garbage collection 40, 57—58, 262-265 
variables 275, 284—286 generics 320-324 

finally block 433, 444, 574—575 classes 321-323 

find Fits), Optional 377 extends or implements 328-330 


methods 324, 375 


Fireside Chats and polymorphic arguments 358-362 


for loop versus forEach method 371 type parameters 362 
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getPreferredSize() 522 
getSequencer() 426 
Getters and Setters 79-82, 646 
getUserInput() 112 
gradient blend, graphics object 475 
Gradle 686 
graphics 471—475. See also GUI 
Graphics superclass 474 
greater than operator (>) 13 
Guessing Game example 38—40 
GUI 461-501 
abstract classes in 204 
BeatBox app 528-533, 674 
BorderLayout 478-482, 511 
BoxLayout 513 
building graphics 471-475 
buttons. See buttons, GUI 
components 462, 471—475, 510, 523-527 
event handling 465-471 
FlowLayout 513 
inner classes 484—494 
layout managers 511-522 


listener interface 466—469 
Swing 462, 509-533 


H 


HAS-A test for inheritance 179-183 
hashCode() 348-351 
heap 40, 57, 238-241 
hexadecimal (%x) formatting type 301 
Hitchens, Ron 

Java NIO 597 
HTML API docs 160 


I 


if/else statement 12, 15 
if statement 15, 697—698 
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if test 15 

images on GUI widget 471, 473 
immutability 688, 700 

immutable objects 658—661, 665—666 
imports, static 303 

import statement 155, 157 


increment/decrement operators (++ and --) 106, 115 


increment(), synchronizing 652 
index position, List 345 
InetSocketAddress 591 


inheritance 31, 168—185. See also polymorphism 
Animal simulation program 172-178 
benefits of using 184—185 
dos and don’ts 183 
implementing abstract methods 206 
keeping trees shallow 191 
relationship to objects 216 
subclasses. See subclasses 
superclass. See superclass 
inheritance trees 191, 220—231 
initializing 
with constructor 246—248 
instance variables 84 
static variables 283 
inner classes 191, 337, 484—494 
drawing 2D graphics 501 
lambda expressions with 490—491 
relationship to outer class 484—486 
two-button code 487 
InputStreamReader 596 


instances, inner and outer class 485—486 


instance variables 34, 35 
Animal simulation program 173, 174 
declaring 84, 238 
default values 84 
Getters and Setters 79 
on heap 241 
inability to use with static methods 279 


initializing 84 
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lack of in Math class 276 history 4 

life and scope of 260-267 setting up Xxx 

versus local variables 85, 238-240 speed and memory usage 4 

matching with parameter types 76 version naming conventions 5 
pass-by-value/pass-by-copy 77 workings of 2-3 

private access modifier for 81 Java API 125-164 

in serialization process 544-546 classes and packages 154—162. See also packages, Java 
setter methods for 80-82 API 

versus static variables 304—305 documentation 158-162 


subclass 169 
transient 549, 550, 553 


int array variable 59 


Java Collections Framework 309. See also collections 
Java-Enabled House 17 

JavaFX 464 

Java I/O, NIO and NIO.2 (Friesen) 597 

Java Module System 161 


integers, incompatibility with boolean variables 14 
interactive components, GUI 510 


interface keyword 226-231 f ; 
java.nio.channels package 597 


Java NIO (Hitchens) 597 


interfaces 199 
functional interface 389-396, 491 


naming 154-156 JavaSound API 421, 423 
polymorphism 226-231 java.util API 314 
intermediate operations 376 Java Virtual Machine. See JVM 


as lazily evaluated 383-384 
chaining operations 380 


JCheckBox 526 
JComponent class 510 
JFrame 462, 510, 522 


creating stream pipeline 379 


int primitive type 51, 53 


I/O 540, 571 JPanel 510, 518 

deserialization 551—555 JPanel.paintComponent() 472-473, 495 

exception handling 574-577 JPEG on widget 473 

networking, See networking JScrollPane 524 

saving data to text file 559-571 i 

saving objects 541—558 JShell-684 

serialization 541—550, 554-557 JTextArea 524-525 

streams 543 JTextArea.requestFocus() 524 
IS-A test 179-180, 183, 188, 253 JTextArea.selectAll() 524 
iteration expression, for loops 114 JTextArea.setLineWrap(true) 524 
iteration variable declaration, enhanced for loop 116 JTextArea.setText() 524 
J JTextField 523 

JTextField.requestFocus() 523 

Java JTextField.selectAll() 523 

pasie lemeng Al JVM (Java Virtual Machine) 9-11 


code structure 7—8 
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K 


key-value pairs, Map 355 
keywords in Java 53, 328 


L 


lambda expressions 340-346, 388-397 
anatomy of 391-392 
calling Single Abstract Method 389 
forEach method 370 
implementing Predicate 402 
map operation 405, 408, 693-694 
method reference replacement for 408 
parameters 393—394 
replacing inner class with 490—491 
threads 612-614, 621 
void return in 393 
latch.countDown 625 


layout managers 509, 511—522, 526 
BorderLayout 478-482, 513-517 
BoxLayout 513 
changing frames 522 
differing policies of 512 
FlowLayout 513, 518-520 

less than operator (<) 13 

limit(), Stream 375-377, 381 

list.addListSelectionListener(this) 527 


listener 467—469, 481 
ActionListener 482, 491 
check.addItemListener(this) 526 
list.addListSelectionListener(this) 527 
non-GUI event 497 
listener interface, event handling 466—469 
List interface 345 
collecting to 383, 400, 409 
Comparator with 331 
sorting with 310-319 
unmodifiable output 356-357, 387 
using versus implementation type 313 
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List.of() 357 


list.setSelectionMode(ListSelectionModel.SINGLE_SE- 


LECTION) 527 
list.set VisibleRowCount(4) 527 
List.sort() 332 
literals, assigning values 52 
local variables 
declaring 238 
versus instance variables 85, 238-240 
life and scope of 260-261, 266-267 
parameters as 74 
references on heap 240 
in Stack 238 
type inference 698 


locking 645-649, 656 
long count() 377 

long primitive type 51, 53 
loop block 13 

loops 12, 13 


for 105, 106, 114-116, 370-373 
while 13, 115, 566 


M 


main() 8, 12, 14, 27 
classes with 9 
ducking exception 442 
multithreading 611, 613 
SimpleStartupGame class 108, 110-111 
StartupBust object 142 
in tester class 36 
uses of 38 
makeEvent() 499-500 


Map interface 355 
Collection API 346 
and collections 409 
key-value pairs 345 
lambda expressions 693-694 
Map.of) 357 


Map.ofEntries() 357 
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map(), Stream 375 

Math.abs() 288 

Math class 276-280, 288-289 
Math.max() 289 

Math.min() 289 

Math.random() 111, 288 
Math.round() 289 

Math.sqrt() 289 

Maven, Java project structure 686 


memory 


garbage collection 262-265 
stack and heap in object lifecycle 238-241 
String immutability 688 


Message, MIDIEvent 449-451, 498 
metadata 572 
method reference, stream 408 


methods 7, 8, 30, 34. See also local variables 


abstract 205—206, 222, 226, 396 

Animal simulation program 173 
arguments. See arguments 

autoboxing 292 

calling non-static from static 280 

versus constructors 245 

declarations and implementations 144—145 
declaring or ducking 441-443 

descriptive naming best practice 698 
exception handling 425-426, 443 

final 191, 285 

generic 321, 324, 362 

inheritability 178 

listener interface 466 

local variables declared inside 85, 238 
making available to all code 41 

matching variable and parameter types 76 
Math class 288-289 

multiple parameters with 76 

multiple return value declarations 78 
non-abstract methods with abstract classes 206 
overloading 193 
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overriding. See overriding methods 
parameters. See parameters 
returning values from 75 
SimpleStartup class test code 102-104 
in Stack 238, 239 
static 276-280 
and static variables 286 
subclasses 182 
superclass 230 
test coding 101 
and type Object’s role in code 212, 215 
varargs 691 
working with inheritance 177—178 
MIDIEvents 449-452, 497-503 
MIDI Music Player 423-424, 446—453 
mocking 310 
mock Songs class 311 


Movie TestDrive class 37 
multiple inheritance problem 224—225 


multithreading 609-630, 695. See also concurrency 


coordinating threads 622—625 
parallel streams 695 

Runnable interface 612-617 
scheduling 617—619 
SimpleChatClient complete 632-633 
sleep() 622-624 

stack 610-614 

thread pools 626-629 

thread states 616 


music video 496-503 


Mutators and Accessors. See Getters and Setters 


N 


naming 
classes and interfaces 154-156 
variables 50-52, 53, 61 
natural ordering in Java (alphabetical) 315 
networking 587—635 


channels. See channels 


client-server relationship 589-593 
simple Chat client app 604—608 
simple Chat server app 606—608 


nextInt() 111 

NIO.2 597 

NIO (non-blocking I/O) 561 

no-arg constructors 247—248, 250 
non-public class 191 

non short circuit operators (& , |) 151 
not equals (!equals and !) 151 

null reference 58, 265 
NumberFormatException 294 
numbers, formatting 296—302 


numeric primitive types 51 


O 


Object class 210-217 

object graph 546, 548, 550 
ObjectInputStream 551 
ObjectOutputStream 542, 543 
ObjectOutputStream.close() 542 
ObjectOutputStream.writeObject() 542 
object references. See reference variables 


objects. See also arrays; Strings 
array elements as 60, 83 
assignment 55, 186-188 
behavior 539. See also classes 
versus classes 35 
and collections 374 
creating 36—37, 55, 242—254 
declaring 186-188 


eligibility for garbage collection 262—265 


equality 86, 348, 349 

in heap 238-240 

immutable 658-661, 665-666 
instance variables as living inside 241 


instantiating 103 


the index 


lambda expressions as 389 
lifecycle of 253, 260-267 
locking 645-649, 656 
of type Object 212 
saving state 539, 541-558 
superclass constructors 252—259 
OO (object-oriented) development 14, 27—48. See 
also classes; objects 
event handling 481 
inheritance 168-185 
saving object state 539 
operators. See also primitive variables 
‘and’ and ‘or’ operators 151 
and autoboxing 293 
comparison 13, 86, 151, 348 
equals (==) 13, 86, 348 
increment/decrement (++ and --) 106, 115 
non short circuit 151 
post-increment 105 
short circuit 151 
optimistic locking 656 
Optional value, returning from collection query 410—414 
outer class, relationship to inner class 484—486 
OutputStream 596 
overloaded constructors 258-259 
overloading methods 193 


overriding constructors 700 


overriding methods 32, 169-194 
hashCode() and equals() 350-351 
Object class 212 
rules to keep contract 192 
superclass 169, 230 
toString() 316 


P 


packages, Java API 154-155 


compiling and running 687 
directory structure 686 
organizing code 686 
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preventing class name conflicts 685 
putting classes in 686 
reverse domain package names 685 
panels, GUI 511-522 
parallelStream 695 
parallel streams 695 
parameterized types 137 
parameters. See also arguments 
lambda expressions 402 
and local variables 85 


matching with instance variable types 76 
and methods 74, 76 
type. See type parameters 
parse methods 294 
pass-by-value/pass-by-copy 77 
Path interface 572-573 
Paths class 572-573 
percent sign (%) in format String 297—300 
PetShop program 220-228 
Phrase-O-Matic code 18-19 
pipelines, stream. See stream pipeline 
polymorphism 
abstract classes 202—205, 208-209 
arguments and return types 189-190 
and exceptions 436—440 
with generic types 321, 358-362 
Graphics superclass 474 
interface implementation 226-231 
and List versus ArrayList 313 
methods 205-206 
Object class 210-215 
reference and object types as different 188—189 
post-increment operator 105 
Predicate 375, 402 
prep code 99 


SimpleStartup class 100—101 
StartupBust class 144-145 
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primitive variables 49, 51 


in arrays 59 

bit-size space 241 
comparing objects 86 
declaring 50-52 
ranges for variables 51 
as reserved words 53 
saving objects 545 
wrapping 290—294 


print) 595 

printf) 296 

println() 595 

printStackTrace() 429 

print versus printIn 15 
PrintWriter 595, 596, 602 

private access modifier 81, 689 
private constructor 191, 251, 278, 282 
protected access level 689, 690 
protected access modifier 689 
pseudocode. See prep code 

public access modifier 81-82, 689 


puzzles 


Five-Minute Mystery 67, 92, 270-271, 415, 669 
GUI-Cross 536 

Heap o’ Trouble 66 

JavaCross 22, 120, 164, 456, 536 

Mixed Messages 90, 121 

Pool Puzzle 24, 44, 91, 196, 234, 416, 506 


Q 


queries 


returning Optional value 410—414 
stream pipelines as queries on collection 380, 385 
terminal operation options 410—412 


QuizCardBuilder 560-563 
QuizCardPlayer 567-569 


R 


race conditions 630, 650 

random() 111 

Random class 111 

random number generators 19, 111 
Reader 594 

Read Eval Print Loop. See REPL 


Ready-Bake Code 
GameHelper class 152-153 
simple Chat server 606 
Songs class 398-399 


records 699-700 


reference variables 49 
accessing in arrays 83 
in arrays 61-62 
assignment 264 
avoiding dot operator exposure of 80 
calling methods by 215 
casting 218 
comparing 86 
equality 348 
garbage-collection heap 57—58 
HeadFirst interview 56 
on heap 240 
life and scope of 260-267 
memory space allotted for 241 
nulling 265 
null reference 58 
and objects of type Object 213-215, 217 
polymorphism 187-188 
size of 56-57 


regions, BorderLayout 514-517 
remote interface. See RMI 
repainting objects, GUI 492-495 
replaceAll 694 

REPL (Read Eval Print Loop) 684 
reserved words 53, 328 
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return keyword, lambda expression 390 


return types 75 


ignoring value of 78 
overloaded methods 193 
polymorphic 189-190, 192 


return values, autoboxing with 292 
reverse domain package names 685 
RMI (Remote Method Invocation) 553 
run() 612, 613 

Runnable interface 612—617 

runnable thread state 616 
RuntimeExceptions 430 

runtime versus checked exceptions 430 


Ryan and Monica concurrency scenario 641—643, 646, 


655—656 


SAM (Single Abstract Method) 341, 389, 394 
scope, variable 260-267 
scrolling (JScrollPane) 524, 527 


security 
and final classes 191 
from package organization in Java library 156 


semicolon (;) 12 

Sequence 446—447 

Sequencer class 424—427, 444, 446-447 
Serializable interface 547—550 


serialization 540, 541-550 
game characters example 554-555 
process 544—546 
versioning 556-557 
writing object to file with stream 542-543 


serialVersionUID 557 
server application, networking 601—603 
server-client relationship 589-593 


server, socket 601 
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ServerSocketChannel 601—602 
Set interface 345, 349 
setLayout(null) 522 
setLocationCells() 102 

Set.of() 357 

setter methods 80-82 

Setters. See Getters and Setters 
short circuit operators (&& ,| |) 151 
ShortMessage instance 450 
ShortMessage.setMessage() 450, 498 
short primitive type 51, 53 
shutdown() 629 

Simple Startup Game 98-124 


SimpleStartupGame class 108-111, 126-130 


SimpleStartupTestDrive class 103—106 
Single Abstract Method. See SAM 

Sink a Startup game 96-97, 140-153 
skip(), Stream 375 

sleep() 622-624 

Socket 596-602 

SocketAddress 594, 595 
SocketChannel 591, 594, 595, 601-602 
Song class 316 

Song object 316-319 

sort() 318-319, 325-330 

sorted() 375, 381, 390 


sorting 
Comparable interface 325-329 
with Comparator 331-338 
List 311-313 
TreeSet 352-354 


source, event 466 

source files, structure of 7 
spillage, variable values 52 
split() 570 
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stack 238-241 
calling methods from 239 
superclass constructor 254—256 
threads 610-614 
variable declarations 238 


stack frame 239 
stack variables. See local variables 
StartupBust class 141—148 
Startup class 138-139, 141, 150 
Startup objects 143 
statements 12 
state of an object. See instance variables 
static final variables 275, 284, 696 
static helper method 408 
static imports 303 
static initializer 284 
static methods 396 

event handling 498—499 


and object locking 649 
and wrappers 294 
static variables 
initializing 283 
versus Instance variables 304-305 
and non-static methods 286 
and serialization 553 
stream pipeline 
creating 379-381 
map operation 405-407 
streams (I/O) 
reading text files 566 
receiving messages 594 
in serialization of object 542—543 
socket connections 596 


streams (Streams API) 369, 373, 375—420 


building blocks 379-381 
collecting results 409—410 
filtering 400—403 

getting results from 378 
inability to reuse 384 


lambda expressions 388-397 
parallel streams 695 
stream() 376, 384 


String arrays 19 
StringBuilder 688 

String class 191 
String.format() method 296 


Strings 62 
immutability 688 
percent sign (%) in 297—300 
reusing 688 
saving data to text file 559-571 
sorting in mock Songs class 311-313 
split) 570 
wrapping and unwrapping 294—295 
subclasses 31, 168—194 
conditions for making 229 
depth of, best practices 191 
as extensions of superclass 179-183 
as instantiators under abstract classes 203 
limitations on 191 
method implementation designs for 174, 175 
and polymorphism 190 
relationship to superclass 182 
and superclass constructors 256 
super() 256, 258 
superclass 31, 168-194 
contract rules 192 
in exception declaration and catch 436-437 
Graphics 474 
invoking superclass version of method 230 
and multiple inheritance 224-225 
and no reverse inheritance 182-186 
overriding methods from 192 
reference type as 188 
relationship to subclasses 179, 184 
superclass constructor 252—259 
super keyword 182 
Swing 462, 464, 509-532 
components 510, 523-527 
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GUI for Beatbox 528-533 
layout managers 511-522 


switch statement 697—698 


synchronization for concurrency in accessing objects 


646-654 
synchronized block or methods, threads 647-649 
synchronized keyword 646-649 
syntax 12, 14 
System.out.print() 15 
System.out.println() 15 


T 


TDD (Test-Driven Development) 101—103 
temporarily not-runnable, thread as 617-619 


terminal operations 377 
collection query options 410—412 
as eager 382-383 
stacking 380 


in stream operations 379 
test code 99, 145 
Test-Driven Development. See TDD 
tester class 36 
testing code, annotations in 692 
text area (JTextArea) 524—525 
text field (JTextField) 523 


text file 
reading from 566-571 
saving data to 540 
writing data to 541, 559-564 


this() 258 

Thread class 609-610 

Thread constructor 614 

thread of execution 609-610 
thread pools 626-629 

threads. See multithreading 
thread-safe data structure 664—666 
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thread scheduler 617—619 
throw clause, exceptions 426, 429-432, 436 
toString() 316 
Track 446 
transient keyword 550 
transient variables 549, 553 
TreeSet 352-354 
try/catch blocks 427—430 
catching multiple exceptions 435, 438 
exception handling role 443 
flow control 432—433 
order of multiple 437—440 
as polymorphic 436-440 
wrapping callin 444 
TWR (try-with-resources) statement 576-577 
type inference 312, 698 
type modifiers, number formats 301 


type parameters 
ArrayList 323 
generic methods 324, 362 
not defined in class declaration 324 
String in angle brackets as 137 
types 
for lambda expression 394 


parameters and methods 78 
variables 50 


U 


underscores for large numbers, formatting 296 


unwrapping a value 290 


y 


values, variable 
object reference as 55 
passing when calling a method 74 
static variables 283 


wrapping and unwrapping 290 
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varargs (variable argument lists) 302, 691 


variables 
in arrays 59-62 
assigning values to 52 
comparing types 86 
concrete type with var 698 
declaring 54, 84, 85, 116, 144 
descriptive naming best practice 698 
final 275, 284—286 
of generic types 321 
instance. See instance variables 
local. See local variables 
naming 50-52, 61 
primitive. See primitive variables 
reference. See reference variables 
static. See static variables 
syntax 12 
types 41 
var for local 698 
version ID, serialization 556—557 
vertical scrollbar 527 


virtual method invocation 177 


W 


while loops 13, 115, 566 
widgets 471 
drawing 2D graphics 471 
images on 473 
wrapper constructor 290 
wrappers 
immutability 688 
Optional as 410—414 
for primitive types 290-294 


writeObject() 543 
Writer 595 
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